Iris不会自动捕获handler中的panic,未处理会导致整个HTTP server崩溃;因其handler是裸函数调用,无内置recover,panic会向上抛至ServeHTTP并可能触发os.Exit(2)或goroutine调度中断。

Iris 不会自动捕获 handler 中的 panic,未处理的 panic 会导致整个 HTTP server 崩溃——这是最危险也最容易被忽略的一点。
为什么 Iris 的 panic 会直接杀掉服务
Iris 的 handler 是裸函数调用,没有内置 recover 包裹。一旦某个请求 handler 里发生 panic(比如 map 访问空指针、JSON 解析失败没检查 error、数据库查询返回 nil 后直接 .ID),它会一路向上抛到 http.Server 的 ServeHTTP,最终触发 os.Exit(2) 或直接中断 goroutine 调度,表现为进程静默退出或 CPU 突增后卡死。
- 不是所有 panic 都立刻可见:有些只在特定参数下触发(如 ctx.Params().Get("id") 返回空字符串后直接转 int,再做除零)
- 中间件里 panic 同样致命,哪怕只是日志中间件里 fmt.Printf("%s", nil)
- ctx.Next() 不提供 panic 捕获能力,和 Gin 的 defer-recover 机制完全不同
必须手动加 recover 中间件
全局 recover 必须作为第一个中间件注册,且要覆盖所有路径(包括 OPTIONS 和健康检查)。不能只在某几个路由上加,也不能靠 controller 层兜底。
- 用 app.Use() 注册,确保它排在所有其他中间件之前
- 中间件内用 defer+recover 捕获 panic,记录堆栈(用 ctx.Application().Logger().Errorf),然后统一返回 500
- 别在 recover 后调 ctx.Next() —— panic 已中断执行流,Next() 无意义
- 示例关键代码:
app.Use(func(ctx iris.Context) { defer func() { if r := recover(); r != nil { ctx.Application().Logger().Errorf("panic recovered: %v", r) ctx.StatusCode(500) ctx.WriteString("Internal Server Error") } }() ctx.Next() })
哪些地方最容易漏掉 error 检查而引发 panic
panic 往往不是来自显式 panic(),而是 nil 指针解引用或类型断言失败。以下操作不检查 error 就调用后续方法,极易出事:
-
ctx.ReadJSON(&v)后直接访问v.Name:若解析失败,v可能是零值,但更危险的是字段 tag 错误导致部分字段未填充,逻辑误判 -
ctx.Params().GetInt64("id")返回 0, false 后仍用该 0 做数据库查询:可能查到错误记录,也可能触发外键约束 panic -
db.QueryRow(...).Scan(&id, &name)后没检查 err,就对&id做非空判断 - 模板渲染时传入 nil 结构体:
ctx.View("user.html", nil)→ 模板引擎 panic
404 和其他错误码要显式注册 OnErrorCode
404 不是 panic,但默认行为是返回空白响应 + 404 状态码,前端难调试。Iris 提供 OnErrorCode 机制,但它只在 handler 显式调用 ctx.StatusCode(404) 后才触发,不会自动捕获未匹配路由。
- 未注册路由默认 404,但不会进
OnErrorCode回调 —— 必须自己写一个兜底路由:app.Any("/{p:path}", notFoundHandler) -
OnErrorCode(iris.StatusNotFound, ...)只对主动设 404 的情况生效,比如业务层查不到用户时手动设状态码 - 生产环境建议合并处理:兜底路由 +
OnErrorCode统一返回 JSON 错误格式,避免暴露框架路径信息
真正的难点不在写 recover,而在识别哪些调用链路可能产生 panic —— 它们往往藏在第三方库返回的 nil、结构体字段零值、或 ctx 方法隐式失败里。每次调用 ReadJSON、Params().Get、DB.Query 前,都要问一句:“如果这里出错,下游会不会解引用 nil?”


















