如何使用Iris框架设计RESTful接口-Golang-PHP中文网

路径参数必须用ctx.Params().Get()，不能用ctx.URLParam()；后者只读查询串，前者才取RESTful路径中如/user/{id}的id值，且参数名大小写敏感。

如何使用iris框架设计restful接口

路径参数必须用 `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}。

Iris框架 12.2.5

Iris框架 12.2.5 版本源码包下载，适合需要 MVC Singleton 控制器、依赖注入字段控制和 debug 错误日志改进的开发者。

下载

必须在控制器的 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 还是会被调用