路径参数必须用ctx.Params().Get()，不能用ctx.URLParam()；后者只读查询串，前者才取RESTful路径中如/user/{id}的id值，且参数名大小写敏感。
路径参数必须用 ctx.Params().Get()，不是 ctx.URLParam()
取不到 ID？八成是用了 ctx.URLParam("id")。它只读 query string（比如 /user?id=123），而 RESTful 路径里的 /user/{id:uint64} 是路径参数，必须走 ctx.Params().Get("id")。
常见错误现象：handler 里 ctx.Params().Get("id") 返回空字符串，后续查数据库无结果，再回头怀疑中间件或 token 验证逻辑——其实参数压根没拿到。
- 参数名大小写敏感：
/user/{ID:uint64}就得用ctx.Params().Get("ID")，写成"id"就是空 - 强类型转换必须检查 err：
id, err := ctx.Params().GetUint64("id")，err != nil时不能直接用id，否则可能 panic - 更稳妥的写法是默认值方法：
id := ctx.Params().GetIntDefault("id", 0)，但要注意语义是否合理（比如 ID 为 0 是否合法）
{id:uint64} 这类宏类型不写会丢掉编译期校验
写成 {id} 看似省事，实际埋雷：非法值如 /user/abc 不会 404，而是进 handler，ctx.Params().GetUint64("id") 返回 (0, error)，你若没判 err，就拿 0 去查库，结果静默错配。
只有写成 {id:uint64}，Iris 才在路由匹配阶段做类型校验，非法值直接 404，不进 handler —— 这是编译期确定的行为，不是运行时判断。
- 宏类型支持
string、int、int64、uint64、bool、float64，不支持自定义类型 -
{path:path}是特例，只能放在路径末尾（如/files/{path:path}），且返回的是原始 URL 编码字符串，需手动url.PathUnescape() - 子路径不会继承控制器前缀：即使路由组挂载在
/users下，BeforeActivation里注册的路径仍是相对根的，要写"/{id:uint64}"，不是"/users/{id:uint64}"
MVC 控制器里不显式注册，GetUserByID 永远不会被调用
Iris 的 MVC 不靠方法名或注解自动绑定路径 —— 它不做任何猜测。你写个 GetUserByID 方法，框架不会识别 “Get” 前缀对应 GET 请求，也不会把它挂到 /users/{id}。
必须在控制器的 BeforeActivation 方法里显式注册：
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")
}
- 路径是相对于根的，不是相对于控制器注册路径；想支持
/users/{id}，就得确保路由组已挂载到/users，且这里写"/{id:uint64}" - HTTP 方法名必须大写字符串：
"GET"，不是"get"或http.MethodGet - 方法名字符串必须和控制器里定义的函数名完全一致（包括大小写）
服务不调 Run() 或 Listen()，整个接口根本不会启动
iris.New() 只返回一个未激活的 app 实例，不监听端口、不启动 HTTP server。写完所有路由、中间件、MVC 注册，go run main.go 后终端静默退出或进程卡住但浏览器打不开 —— 这不是 bug，是忘了启动。
常见错误现象：app.Get("/health", handler) 写得再全，没 Run() 就等于没写；看不到 Now listening on http://localhost:8080 日志，说明服务压根没跑起来。
- 推荐用
app.Run(iris.Addr(":8080"))，简洁且支持 TLS（配合iris.TLS("cert.pem", "key.pem")） - 旧版
Listen(":8080")仍可用，但不支持 TLS 配置，若混用TLS()却没调ConfigureHost()，HTTPS 会静默失败 - 中间件里写完响应后必须调
ctx.StopExecution()，否则ctx.Next()仍会执行后续逻辑 —— JWT 验证失败后返回 401 却漏掉StopExecution()，业务 handler 还是会被调用
StopExecution() 漏调 —— 前者让非法请求进 handler，后者让鉴权失效后逻辑继续执行。 
