Go语言URL查询参数解析与动态字符串构建实践

根本原因是原始URL的RawQuery未合法编码，如?name=张三会导致url.Parse()丢弃整个query，使Query()返回空map；Query()自动解码，但前提是RawQuery格式正确（key=value、&分隔、值已编码）。

Query() 返回空或中文变成 %E4%B8%AD 是怎么回事

根本原因不是 Go 解析错了，而是原始 URL 的 RawQuery 本身就不合法 —— 比如手拼的 ?name=张三 或 ?q=hello world，空格、中文、&、= 等字符未经 url.QueryEscape 编码，url.Parse() 会直接丢弃整个 query 部分，导致 Query() 返回空 map。

真正起作用的是 Query() 方法：它内部调用 url.ParseQuery(u.RawQuery) 并自动解码值。但前提是 RawQuery 格式正确（key=value 形式、& 分隔、值已编码）。

• 合法示例：https://a.com/?q=%E4%B8%AD%E6%96%87&tag=go → u.Query().Get("q") 得到 "中文"
• 非法示例：https://a.com/?q=中文 → u.Query() 返回空 map，u.RawQuery 可能是空或只含部分参数
• 救急办法：若必须处理“脏 URL”，跳过 Query()，直接对 u.RawQuery 调用 url.ParseQuery()，它容忍度更高，且返回 map[string][]string

别用字符串拼接构造 query，用 url.Values.Encode()

写 urlStr := "https://api.com/search?q=" + keyword + "&sort=asc" 是高危操作 —— keyword 里只要出现空格、中文、&、=、/，生成的 URL 就非法，服务端收不到完整参数，甚至被截断或注入。

url.Values 是唯一安全的中转层，它内部强制调用 url.QueryEscape 对每个值编码，且自动处理重复 key、多值等边界情况。

立即学习“go语言免费学习笔记（深入）”；

• 单值覆盖用 v.Set("q", "Go语言")
• 多值追加用 v.Add("tag", "backend")、v.Add("tag", "cli")
• 最终必须用 v.Encode() 得到 query 字符串，再赋给 u.RawQuery
• 切记：修改 u.RawQuery 后，要调用 u.String() 才能得到完整合法 URL，不能直接拼接

路径 segment 和 query 参数编码不能混用 url.PathEscape / url.QueryEscape

路径中的特殊字符（如 /、?、#）和查询参数中的特殊字符（如 &、=、空格）编码规则不同，用错函数会导致解析失败或服务端 400。

url.PathEscape 专用于路径段（path segment），它保留 / 不编码；url.QueryEscape 专用于 query 值，它把 / 编成 %2F，把空格编成 %20。

• 错误：用 url.QueryEscape("/api/v1") → %2Fapi%2Fv1，塞进 u.Path 会导致路径被当成字面量，找不到路由
• 正确：路径部分用 url.PathEscape("user/张三") → user%2F%E5%BC%A0%E4%B8%89，再拼进 u.Path
• 查询参数值一律用 url.QueryEscape，哪怕它是 URL 字符串（如 url.QueryEscape("https://x.com/a?b=c")）

修改 URL 字段后必须调用 u.String() 才生效

url.URL 结构体字段（Scheme、Host、Path、RawQuery 等）只是数据容器，它们之间没有自动同步逻辑。改了 u.Path 不等于 URL 字符串变了，也不影响 u.String() 的输出结果 —— 直到你显式调用它。

常见误区是改完字段就直接打印 u 或传给 HTTP client，结果发出去的还是旧 URL。

• 修改任意字段后，最终输出或发送前，必须执行 finalURL := u.String()
• 如果只改 RawQuery，别忘了它必须是 url.Values.Encode() 的结果，不是原始键值对字符串
• 注意 Fragment 字段不参与网络传输，但会影响前端路由，修改后同样要走 String()

最易被忽略的是：路径和 query 的编码责任完全在使用者手上，net/url 不会帮你补救“看起来差不多”的字符串 —— 它只认 RFC 3986 合规输入。