URL解析失败时需检查RawQuery和Fragment是否被截断;未编码的#、&、=会导致字段错位,应提前用url.QueryEscape或url.PathEscape对相应部分转义,修改url.URL后必须调用String()生成新URL。
URL解析失败时检查RawQuery和Fragment是否被意外截断
Go 的 url.Parse 默认会把 # 后面的内容当作 Fragment,而 ? 后面直到 # 前的部分归入 RawQuery。如果原始 URL 里有未编码的 &、= 或 #,解析后字段可能错位——比如本该在查询参数里的 name=foo#bar 被拆成 RawQuery="name=foo" 和 Fragment="bar",但实际你想保留 # 作为参数值。
- 先用
strings.Contains检查原始字符串是否有未编码的特殊字符 - 若需保留字面量(如 API 返回含
#的参数值),应提前对整个查询部分做url.PathEscape,再拼接 -
url.Parse不校验查询参数格式,所以?a&b=c会被接受,但Query()方法返回的url.Values里a对应空字符串,b才是c
用url.QueryEscape还是url.PathEscape?看位置
这两个函数逃逸规则不同:QueryEscape 把空格转成 +,且不编码 /、?;PathEscape 把空格转成 %20,并严格编码所有非 URL path 字符(包括 /)。选错会导致 400 或路由匹配失败。
- 查询参数值(
?q=xxx中的xxx)用url.QueryEscape - 路径段(
/user/xxx中的xxx)必须用url.PathEscape,否则/不会被编码,服务器可能误判层级 - 不要对整个 URL 字符串调用任一 escape 函数——它们只设计用于单个字段
url.URL结构体修改后必须调用String()才能生成新URL
url.URL 是值类型,字段可直接赋值(如 u.Scheme = "https"),但这些修改不会自动同步到最终字符串表示中。Go 不重载 + 或隐式转换,也没有“构建器”方法。