Iris动态路由必须用{ name }或{ name:type }语法，如/user/{id}；禁用/:id或嵌入正则的错误写法；参数获取须用ctx.Param()而非URLParam；正则需括号包裹且不加^$；关键处应校验参数非空。
动态路由在 Iris 中靠路径段占位符实现，不是靠字符串拼接或运行时解析——写错格式或顺序，参数就拿不到。
怎么写动态路由路径才被正确识别
Iris 的动态路由必须用 {name} 或 {name:type} 语法，写在路径字符串里，比如 /user/{id}、/post/{year:int}/{month:uint8}。不能写成 /user/:id（那是 Gin/Beego 风格），也不能用正则直接嵌在路径里如 /user/{id[0-9]+}（会 panic）。
常见错误：
- 把
{id:int}写成{id:int64}—— Iris 只认内置类型名：int、uint、string、bool、float64等，不支持 Go 类型全名 - 路径中多个参数连续出现，但 handler 里调用
ctx.Param("Id")（大小写错）→ 返回空字符串""，不会报错 - 用了
{id:int min(1)}这类约束，但没在 handler 里检查ctx.Params().GetIntDefault("id", 0)的返回值是否为 0 → 可能误把非法请求当合法处理
ctx.Param() 和 ctx.Params() 怎么选
ctx.Param("id") 最常用，返回 string，安全、简洁，适合单个参数读取；ctx.Params() 返回一个只读映射，适合批量操作或日志记录。
注意点：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
ctx.Param("xxx")在参数名不存在时返回""，不会 panic，但你要自己判断是否为空 - 如果路由是
/file/{path:path}（通配符），必须用ctx.Param("path")，不能用ctx.Param("*path")—— 后者是旧版写法，已弃用 -
ctx.Params().Get("id")和ctx.Param("id")行为一致，但前者多一次 map 查找，无实际性能差异
带正则的参数怎么写才不崩溃
正则必须放在括号里，且只能是纯匹配逻辑，例如 /user/{id([0-9]{1,8})}。Iris 不会帮你校验或截断，只决定“这个请求进不进这个 handler”。
容易踩的坑：
- 写成
/user/{id((\d+))}→ 外层括号被当成捕获组，Iris 解析失败，启动时报 panic - 正则里加
^或$→ Iris 会自动锚定到整个参数段，重复加会导致匹配永远失败 - 以为加了
{id([0-9]+)}就能在 handler 里放心用strconv.Atoi(ctx.Param("id"))→ 其实仍需 error check，因为ctx.Param()返回的是原始字符串，不保证可转数字
为什么 ctx.URLParam() 拿不到路径参数
ctx.URLParam("id") 是查 query string 的，比如 /user?id=123；而路径参数（/user/123）必须用 ctx.Param("id")。
混淆后果很直接：
- 用
ctx.URLParam("id")读/user/123→ 返回空字符串"" - 用
ctx.FormValue("id")读路径段 → 同样返回空，它只读表单或 JSON body 里的字段 - 用
ctx.Request().URL.Path手动切分 → 容易出错，且绕过 Iris 的参数标准化（比如自动去除前导 / 或解码）
最麻烦的不是拿不到参数，而是拿错位置后逻辑静默失效——比如权限检查用错了变量名，结果所有请求都走默认分支。建议在关键 handler 开头加一句 if id := ctx.Param("id"); id == "" { ctx.StatusCode(400); return }，比后期 debug 强得多。
