Go URL 拼接时怎么避免双斜杠和转义重复

Go 里把 baseURL + "/" + id 写起来很快，但一旦基础地址末尾已经有斜杠，结果就可能出现双斜杠；如果又先调用 QueryEscape 再交给 url.Values.Encode，百分号还会被再次编码。稳定的做法是把 URL 拆成两种语义：路径片段交给 URL.JoinPath，查询参数交给 url.Values，每个动态值只编码一次。

先分清路径片段和查询参数的职责

同一个字符串放在不同位置，语义并不一样。users、alice%2Fteam 是路径中的资源层级；q=Go&page=2 是查询条件。路径里的斜杠会改变层级，查询里的斜杠只是参数值的一部分，所以不能用同一个 Escape 函数处理两者。

可以把这组关系记成：PathEscape 保护一个路径片段，url.Values 管理查询字段，URL.Path 和 URL.RawQuery 分别保存两种结果。下面的代码只展示职责划分，不运行外部请求。

package main

import (
	"fmt"
	"net/url"
)

func main() {
	// 路径片段中的斜杠要被保护，避免把一个标识拆成两级路径。
	resourceID := url.PathEscape("alice/team")

	// 查询值交给 Values 统一编码，不要提前调用 QueryEscape。
	query := url.Values{}
	query.Set("q", "Go URL")
	query.Set("page", "2")

	fmt.Println(resourceID)
	fmt.Println(query.Encode())
}

这里的判断重点不是“有没有百分号”，而是百分号属于哪一层。路径片段中的 alice/team 变成 alice%2Fteam 后，仍然是一个片段；查询编码则会同时处理空格、加号和 &。如果把已经编码的 q=Go%20URL 再放进 Values.Set，百分号就会变成 %25。

用 URL 对象拼接，避免斜杠和转义重复

基础地址来自配置时，不要假设它一定是 https://api.example.com，也不要用 strings.TrimRight 和字符串加法堆出每一层路径。先解析成 url.URL，再调用 JoinPath，基础地址末尾和片段开头多出的斜杠会被统一处理。

package main

import (
	"fmt"
	"log"
	"net/url"
)

func buildUserURL(base, userID string, keyword string) (string, error) {
	// 先解析基础地址，让 scheme、host、path 和 query 保持独立。
	u, err := url.Parse(base)
	if err != nil {
		return "", err
	}

	// JoinPath 负责清理路径边界；userID 已是一个完整路径片段。
	u = u.JoinPath("users", url.PathEscape(userID))

	// 查询参数单独维护，Encode 只在最终输出前调用一次。
	q := u.Query()
	q.Set("q", keyword)
	q.Set("page", "1")
	u.RawQuery = q.Encode()
	return u.String(), nil
}

func main() {
	// 基础地址和动态值都故意带边界字符，便于检查结果。
	got, err := buildUserURL("https://api.example.com/", "alice/team", "Go URL")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(got)
}

这段实现有两个关键点：JoinPath 处理的是路径结构，不负责替你猜测查询参数；u.Query() 返回可编辑的 url.Values，写回 RawQuery 后才会进入最终 URL。若项目需要兼容较老的 Go 版本，可以退回到 strings.TrimRight 加 strings.Trim 的最小拼接，但仍要保留“路径和查询分开”的原则。

用边界样例检查最终字符串

不要只用普通的 42 测试。至少准备四类输入：基础地址有无末尾斜杠、路径片段含中文、路径片段含斜杠、查询值含空格和加号。检查时关注三个结果：路径层级是否正确、查询分隔符是否只有一套、输出中是否出现意外的 %25。

还要区分 Path 和 EscapedPath()。URL 内部保存的是解码后的路径语义，最终字符串会按需要重新转义；如果业务必须观察原始转义形式，应调用 EscapedPath()，不要直接把 RawPath 当成普通字符串修改。

一个实用的检查清单是：路径边界由 JoinPath 处理；路径片段最多 Escape 一次；查询字段只通过 Values 写入；最终输出只调用一次 String。做到这四点，绝大多数双斜杠和转义重复问题都能在代码评审时被发现。

常见问题

PathEscape 和 QueryEscape 可以互换吗？

不可以。PathEscape 服务于路径片段，QueryEscape 服务于查询字符串；更推荐直接用 url.Values 管理查询参数。

为什么结果里会出现 %252F？

通常是 %2F 已经编码过一次，又被当作普通字符交给第二层编码，百分号被编码成了 %25。沿着“谁负责第一次编码”回溯即可。

JoinPath 会保留路径里的双斜杠吗？

它会清理路径元素之间的边界斜杠，但不要把它当作业务语义转换器。若双斜杠本身是资源协议的一部分，应先明确协议要求，再决定是否使用 JoinPath。