Iris单元测试必须为每个测试函数独立创建app实例并调用app.Build(),否则因路由未构建而panic;需用app.NewContext构造上下文,手动处理Validate错误,严格匹配路径参数与注册格式。

iris.Application 必须调用 app.Build() 才能测试路由
不调用 app.Build() 是单元测试里最常 panic 的原因。Iris 的路由树在初始化时是惰性的,app.Get 等注册只是把 handler 记进 registry,真正构建 trie 树要靠 app.Build() 显式触发。测试中漏掉这行,app.ServeHTTP 会直接 panic “no routes found”。
- 必须放在
app.Get/app.Post注册之后、app.ServeHTTP之前 - 不能只在 TestMain 里调用一次——每个测试函数都得独立调用,避免路由互相污染
- Iris v14+ 默认 strict routing,
/users和/users/被视为不同路由,测试路径要和注册时完全一致
别用 iris.Default(),每个测试都要 new 独立 app 实例
用 iris.Default() 写测试,等于把所有测试塞进同一个全局状态里。中间件、错误处理器、依赖注入容器全会被后续测试覆盖或干扰,尤其并发运行时必出问题。
- 正确写法:每个
TestXxx函数开头都写app := iris.New() - 如果用了
app.ConfigureContainer注册 mock DB 或其他依赖,也要在当前测试内完成,不要复用上一个测试的容器 - 绝对不要在测试里调用
app.Listen或app.Run——它们会阻塞 goroutine,导致测试卡死或端口冲突
构造 ctx 要用 app.NewContext,不能 new *iris.Context
*iris.Context 不是普通结构体,它强依赖内部 registry 和生命周期管理。直接 &iris.Context{} 会 panic,必须通过 app.NewContext(w, req) 获取。
-
req用httptest.NewRequest(method, path, body)构造,body 为nil(GET)或bytes.NewReader(jsonBytes)(POST) -
w用httptest.NewRecorder(),之后通过w.Code和w.Body.String()检查响应 - 若 handler 里用了 session(
c.Session()),需手动调用c.StartSession(),否则 panic
参数校验失败时,iris.Validate 不会自动返回 400
iris.Validate 只做校验并返回 error,它不会自动设置 status code 或写响应体。很多人以为加了 tag 就万事大吉,结果校验失败时 handler 还继续往下跑,造成空指针或逻辑错乱。
- 必须显式处理:
if err := iris.Validate(&req); err != nil { c.StopWithError(iris.StatusBadRequest, err); return } - 路径参数(如
/user/{id})和查询参数(如?page=2)不走Validate,得手动取值 + 类型转换 + 边界检查 - 推荐用
c.Params().GetInt64("id")而非c.Params().GetInt("id"),前者返回(int64, error),能明确区分“没传”和“转失败”


















