gin中需用c.request.url.rawquery配合url.parsequery获取原始未解码query参数，因c.query()和c.request.url.query()均返回已解码结果；路径参数无法保留原始编码，因net/http在gin前已标准化path。
GET 请求中百分号被自动解码导致路由匹配失败
Gin 默认会对 URL 中的 % 字符进行 URL 解码，比如请求 /api/v1/file?name=a%25b（原意是传入字符串 a%b），Gin 会把它变成 a%b 再交给路由处理。但如果你的路由规则里写的是 GET /api/v1/file，参数用 c.Query("name") 获取，那看起来没问题——可一旦你依赖原始编码形式（比如做签名校验、透传给下游服务、或匹配带 % 的文件名），就出错了。
根本原因不是 Gin “解码错了”，而是它按标准把 %25 → %，这是 HTTP 协议层该做的事；问题在于你没意识到这个转换已发生，还误以为拿到的就是原始字符串。
-
c.Request.URL.Query().Get("name")和c.Query("name")返回的都是已解码结果，不可逆 - 如果必须保留原始编码（比如
%25而非%），得从c.Request.URL.RawQuery手动解析，跳过 Gin 的 query 解析逻辑 - 注意：
RawQuery是整个查询字符串（如name=a%25b&tag=hello%20world），你要自己 parse 并保留编码
如何安全获取原始未解码的 query 参数值
直接用 c.Query() 拿不到原始编码，得绕开 Gin 的封装，操作底层 *http.Request。关键点是别碰 c.Request.URL.Query()，它已经解码过了；改用 c.Request.URL.RawQuery + 手动解析。
示例：提取原始 name 参数值（含 %25 不变）：
rawQuery := c.Request.URL.RawQuery
values, _ := url.ParseQuery(rawQuery)
nameRaw := values.Get("name") // 这里 nameRaw 是 "a%25b"，不是 "a%b"
注意：url.ParseQuery 对 RawQuery 做的是“解析键值对”，但不会对 value 做额外解码——因为它本来就是原始字节流。这正是你需要的。
- 必须用
url.ParseQuery，不能用url.Parse后取.Query()，后者又会触发一次解码 - 如果参数名本身也含特殊字符（比如
user%40domain作 key），ParseQuery仍能正确识别，因它按=和&切分，不依赖 key 解码 - 若请求带重复 key（如
?x=1&x=2），values.Get("x")只返回第一个，需用values["x"]获取全部原始值
Gin 路由路径含百分号时 404 的真实原因
不是 Gin 不支持 %，而是 net/http 服务器在接收请求时，已对 path 部分做了标准化处理：把 %2F → /、%2E%2E → .. 等。如果路由定义为 GET /file/:name，而用户请求 /file/a%25b，Gin 实际收到的 c.Param("name") 是 a%b —— 因为 path 解码发生在 Gin 接手之前。
这意味着：你无法在路由参数里“原样保留” %25，这是 Go 标准库的强制行为，Gin 无权绕过。
- 若业务必须用含
%的路径做标识（如短链 IDabc%25def），唯一可靠方式是把这部分挪到 query 里，走上面说的RawQuery方案 - 不要尝试用正则路由匹配
%25，因为 path 已被标准化，正则永远匹配不到原始编码 - 开发时用
curl -v "http://localhost:8080/file/a%25b"测试，再打印c.Param("name")确认是否被解码，避免凭空猜测
前端传参和后端接收的编码一致性检查
很多问题其实源于前后端对编码的理解错位。比如前端用 encodeURIComponent("a%b") 得到 "a%25b"，但后端却用 decodeURIComponent 再解一次，变成 "a%b" → "ab"（因为 %b 不是合法转义），彻底乱码。
建议统一约定：前端只做一次编码，后端只做一次解码（或不做），且双方明确哪一层负责。
- 前端发请求前，确认是否多调了一次
encodeURI或encodeURIComponent—— 特别是拼接 URL 时容易重复编码 - 后端除非必要，不要对
c.Query()结果再调url.QueryEscape或url.PathEscape，那是画蛇添足 - 调试时用
fmt.Printf("raw: %q, decoded: %q\n", rawValue, url.QueryUnescape(rawValue))对比，快速定位在哪一层被多解了一次
真正难的不是写代码，是确认哪一环悄悄做了你不知道的编/解码。盯住 RawQuery 和 c.Request.URL.Path 这两个原始字段，比猜更可靠。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
