必须用ctx.Params().Get("id")获取路径参数，而非ctx.URLParam()；{id:uint64}需配合宏实现编译期校验，非法值直接404；参数名大小写敏感，强类型转换须检查err或用默认值方法。
怎么从路径里正确取到 {id:uint64} 这类参数
别用 ctx.URLParam("id") —— 它只读 query string（比如 /user?id=123），而 RESTful 路径里的 /user/{id:uint64} 是路径参数，必须走 ctx.Params().Get("id")。
常见错误是取出来为空，然后去查数据库查不到，再回头怀疑 token 或中间件逻辑，其实只是参数根本没拿到。
- 参数名大小写敏感：
/user/{ID:uint64}就得用ctx.Params().Get("ID")，写成"id"就返回空字符串 - 强类型转换要检查错误：用
ctx.Params().GetUint64("id")时，err != nil必须处理，否则后续用userID可能 panic - 更稳妥的做法是用默认值方法：
ctx.Params().GetIntDefault("id", 0)，避免崩溃但要注意语义是否合理
为什么 /users/{id} 不自动绑定到 GetUserByID 方法
Iris 的 MVC 不靠方法名或注解自动推导路径 —— 它不做任何猜测。你写 GetUserByID，框架不会自动把它挂到 /users/{id}，也不会识别 Get 前缀对应 GET 请求。
必须在控制器的 BeforeActivation 阶段显式注册：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
func (c *UserController) BeforeActivation(b mvc.BeforeActivation) {
b.Handle("GET", "/{id:uint64}", "GetByID")
b.Handle("PUT", "/{id:uint64}", "Update")
b.Handle("DELETE", "/{id:uint64}", "Delete")
}
- 路径宏类型要写对：
{id:uint64}才能确保非法值（如/users/abc）直接 404，不进 handler；写成{id}会导致参数始终为零值 - 子路径不会继承前缀：即使控制器注册在
/users下，BeforeActivation里写的路径仍是相对根的，不是相对/users - 如果想支持
/users/{id}，就得写b.Handle("GET", "/{id:uint64}", "GetByID")并确保路由组已挂载到/users
怎么捕获完整子路径，比如 /files/a/b/c.txt
普通参数如 {name} 只匹配单段，要拿整个路径片段，得用 {path:path} 类型，并注意位置限制。
- 必须放在路径末尾：
/files/{path:path}合法，/files/{path:path}/meta会报错或不匹配 -
ctx.Params().Get("path")返回的是原始 URL 编码字符串，比如请求/files/hello%20world.txt，得到的是"hello%20world.txt"，不是"hello world.txt" - 需要手动解码：
url.PathUnescape(pathStr)，否则空格、斜杠等可能被误判 - 不做自动校验：Iris 不会对
path类型做长度、格式约束，这部分得自己在 handler 里校验
自定义宏怎么提前拦截非法参数，比如 id 必须在 1~999999
与其在 handler 里写一堆 if 判断，不如让 Iris 在路由匹配阶段就拒绝非法请求，减少无效执行。
注册自定义宏后，就能在路由中写 {oid:int min(1) max(999999)}，Iris 会在解析 URL 时直接跳过该路由（返回 404），不调用 handler。
- 典型场景：
app.Get("/order/{oid:int min(1) max(999999)}", orderHandler)，请求/order/0或/order/1000000都不会命中 - 宏函数需提前注册，且只对声明了对应宏的参数生效；没声明宏的
{id}或{id:int}不触发范围检查 - 这种校验发生在中间件之前，性能好，也避免 handler 里重复写防御逻辑
