go 的 `url.url` 结构在设置 `rawquery` 时会对 url 路径中已存在的 `%` 字符进行二次编码，导致如 `test%` 变为 `test%2525`，本质是原始字符串中 `%` 被误作未完成的编码序列而重复转义。
在 Go 中，url.URL 类型对 URL 各字段（如 Path、RawQuery）的处理遵循 RFC 3986 规范：只有 RawQuery 和 RawFragment 字段被视作“已编码”的原始字节，其余字段（如 Path、Scheme、Host）在调用 u.String() 时会自动进行标准化编码。关键在于：url.URL.Path 字段不接受部分编码的输入——如果你将 test% 直接赋值给 u.Path，Go 会认为这个 % 是一个孤立的、未完成的百分号编码（如 %25 表示 %），从而将其安全转义为 %25；而当 RawQuery 中又包含原始 %（例如来自未经解码的请求路径），它会被再次编码，最终出现 %2525 这样的双重转义。
以你的示例为例：
baseURL, _ := url.Parse("http://localhost:9000")
path := "buckets/test%?bucket_uuid=7864b0dcdf0a578bd0012c70aef58aca"
u := *baseURL
u.User = nil
q := strings.Index(path, "?")
if q > 0 {
u.Path = path[:q] // → "buckets/test%" → % 被视为非法裸字符，编码为 "%25"
u.RawQuery = path[q+1:] // → "bucket_uuid=..."（无 %，安全）
} else {
u.Path = path
}
log.Printf("url %v", u.String())
// 输出：http://localhost:9000/buckets/test%25?bucket_uuid=...但你实际输入的 path 很可能本身已是经过一次编码的字符串（例如从 HTTP 请求 URI 中直接截取），其中 test% 实际应为 test%25（即原始意图是路径含字面量 %）。此时若再将 test% 当作 Path 赋值，Go 会把它当作未完成编码处理，生成 %25；而若原始 path 是 test%25?...，则 path[:q] 得到 test%25，其中 %25 被解析为合法编码，u.Path 保持为 test%（解码后），但 u.String() 在序列化时会对 Path 中的 % 再次编码 → test%2525。
✅ 正确做法是：确保传入 u.Path 的是语义正确的、未编码的 Unicode 字符串（Go 会自动编码），而 u.RawQuery 必须是已正确编码的 ASCII 字符串，且不含孤立 %。
推荐修复方案：
import (
"net/url"
"strings"
)
func buildURL(baseURL *url.URL, path string) *url.URL {
u := *baseURL
u.User = nil
// 1. 安全分离 path 和 query —— 使用 url.ParseQuery 不依赖手动切分
if q := strings.Index(path, "?"); q >= 0 {
u.Path = path[:q]
// 2. 对 RawQuery 使用 url.QueryEscape 保证编码合规（若 query 来自用户输入）
// 或直接使用已编码的 query 字符串（如来自 r.URL.RawQuery）
u.RawQuery = path[q+1:]
} else {
u.Path = path
}
// ✅ 关键：若 u.Path 中可能含特殊字符（如 %、/、中文），应先 url.PathEscape()
// 但注意：url.PathEscape("test%") → "test%25"，这才是符合规范的写法
// 所以更健壮的做法是：统一用未编码字符串构造，由 Go 自动处理
// 即：u.Path 应设为 "buckets/test%"（语义值），但需确保该 % 是真实需求而非错误残留
return &u
}
// 更安全的构造方式（推荐）：
func safeURL(base *url.URL, pathWithoutQuery string, queryValues url.Values) *url.URL {
u := *base
u.User = nil
u.Path = pathWithoutQuery // 如 "buckets/test%"
u.RawQuery = queryValues.Encode() // 自动编码键值对，无风险
return &u
}⚠️ 注意事项：
- 永远不要将未经校验的原始请求路径（尤其是含 ? 的完整 URI）直接切分后赋值给 u.Path 和 u.RawQuery；
- 若 path 来自外部（如 API 参数），应先 url.PathUnescape 解码再处理，或改用 url.Parse() 全量解析；
- u.RawQuery 必须是符合 application/x-www-form-urlencoded 格式的 ASCII 字符串，不能包含未编码的空格、&、=、% 等；
- 测试时可用 url.Parse(u.String()) 验证结果是否可逆，避免歧义。
总结：%2525 是典型「编码污染」现象——根源在于混淆了「原始语义字符串」与「URL 编码字符串」的边界。Go 的 url.URL 设计要求开发者明确区分各字段的编码状态，严格遵循「Path 传语义，RawQuery 传编码」原则，即可避免此类问题。
