Iris框架不自动解码路径参数，ctx.Params().Get()返回的是RFC 3986编码后的字符串（如%E4%B8%AD），因路由匹配在net/http标准化后、中间件前完成，未调用url.PathUnescape；必须显式用url.PathUnescape解码并校验错误。
Iris 默认对 URL 路径中的中文和特殊字符（如空格、括号、中文标点）做 URL encoding 处理，但框架本身**不自动解码路径段**——这意味着你从 ctx.Params().Get("name") 拿到的可能是 %E4%B8%AD%E6%96%87 或 %20 这类编码串，而非原始字符串。
为什么 ctx.Params().Get() 返回的是编码后的字符串
Iris 的路由匹配发生在 HTTP 请求解析之后、中间件执行之前，此时 net/http 已将原始请求路径按 RFC 3986 规范做了初步标准化，但不会调用 url.PathUnescape。所以所有路径参数（包括普通 {id} 和通配 {path:path}）都保持原始编码状态。
常见错误现象：
- 请求
/user/张三→ctx.Params().Get("name")返回%E5%BC%A0%E4%B8%89，直接用于文件名或数据库查询会失败 - 路径含空格如
/files/my%20report.pdf→ 解析出"my%20report.pdf"，os.Open找不到该文件 - 中文路由别名生成 URL 时，
c.Router().URI("user.detail", iris.Map{"name": "李四"})生成/user/%E6%9D%8E%E5%9B%9B，但浏览器地址栏显示正常，后端却未解码
手动解码路径参数必须用 url.PathUnescape
不能用 url.QueryUnescape（它专为 query string 设计，会错误处理 + 和斜杠），必须用 url.PathUnescape —— 它专为路径段设计，保留斜杠并正确处理 UTF-8 编码字节序列。
实操建议：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 对每个需要语义处理的路径参数，显式调用
url.PathUnescape - 务必检查解码错误：
decoded, err := url.PathUnescape(raw)，err != nil表示非法编码（如%zz），应返回 400 - 若使用
{path:path}类型通配，解码后得到的是完整子路径（如a/b/测试.txt），需再用path.Base或path.Dir分割，不能直接当文件名用
示例：
func handler(ctx iris.Context) {
raw := ctx.Params().Get("filename")
decoded, err := url.PathUnescape(raw)
if err != nil {
ctx.StatusCode(iris.StatusBadRequest)
ctx.WriteString("invalid path encoding")
return
}
// decoded 现在是真正的中文字符串
os.Open(decoded) // ✅ 安全使用
}
路由定义和别名生成时的编码行为差异
路由注册时写的路径模板（如 /user/{name}）本身不参与编码；但通过别名反向生成 URL 时，c.Router().URI() 会对传入的参数值自动做 url.PathEscape，这是安全且必要的。
关键点：
- 别名生成是「输出」环节，框架帮你 escape；路径参数读取是「输入」环节，你必须自己 unescape
- 参数键名大小写敏感，且必须与路由中声明的完全一致，否则
URI()会保留{name}占位符 - 如果传入的参数值本身已编码（如前端重复 encode），
URI()会再套一层，导致双重编码 —— 应确保传入的是原始字符串
最易被忽略的一点：Iris 不提供全局路径自动解码开关。哪怕你写了 /用户/{姓名} 这样的路由，底层仍按字节匹配，而浏览器发送的其实是 /%E7%94%A8%E6%88%B7/%E5%90%8D%E5%AD%97。所以解码动作无法省略，也不能推迟到业务逻辑深处——必须在 handler 开头就完成，否则后续所有基于该字符串的判断（如权限校验、文件存在性检查）都会出错。
