Fiber 的 panic 不会自动转成 500 响应,因其默认不拦截 handler 内 panic,仅打印堆栈并终止 goroutine;需手动用 defer+recover 封装 handler 入口,且异步 goroutine 需单独 recover。

为什么 Fiber 的 panic 不会自动转成 500 响应
Fiber 默认不拦截 handler 内部的 panic,和标准库 http.Server 一样:它只打印堆栈到日志、关闭连接,然后让当前 goroutine 死掉。前端看到的是空响应或连接重置,不是 500 Internal Server Error;日志里只有模糊的 PANIC in GET /xxx,没有 traceID、无上下文、无法关联请求链路。
这不是 bug,是设计选择——Go 不提供隐式异常兜底。Fiber 作为轻量 HTTP 框架,把错误处理权交还给开发者,而不是替你做决定。
- 中间件(如 JWT 验证、日志记录)在 panic 后不再执行,资源未清理
- 自定义错误页、统一监控、告警上报全部失效
- 如果你依赖
defer做清理(比如释放 DB 连接),但没在 handler 入口注册recover,那 panic 一发生,清理逻辑就永远不跑了
必须用 defer+recover 封装每个 handler 入口
不能靠“全局中间件”一劳永逸。Fiber 的中间件本质是链式调用,recover() 只对当前 goroutine 有效,且必须在 panic 触发点之后仍处于调用栈上。常见错误写法:
func BadRecovery(next fiber.Handler) fiber.Handler {
return func(c *fiber.Ctx) error {
// ❌ 错误:recover() 在普通逻辑里调用,恒返回 nil
if r := recover(); r != nil {
c.Status(500).SendString("oops")
return nil
}
return next(c)
}
}
正确做法是把 recover 放进 defer,且确保它在 next(c) 之前注册:
立即学习“go语言免费学习笔记(深入)”;
func Recovery() fiber.Handler {
return func(c *fiber.Ctx) error {
defer func() {
if r := recover(); r != nil {
buf := debug.Stack()
log.Printf("PANIC in %s %s: %v\n%s", c.Method(), c.Path(), r, buf)
if !c.Response().Written() {
c.Status(500).SendString("Internal Server Error")
}
}
}()
return next(c)
}
}
-
defer必须在next(c)调用前注册,否则栈已展开,recover 失效 -
c.Response().Written()要检查,否则已写部分响应后再调c.Status()会触发二次 panic - 别用
debug.PrintStack(),它直接输出到 stderr,不可控;用debug.Stack()拿字节切片再交由日志系统处理
goroutine 内 panic 必须单独 recover
你在 handler 里起一个 go func() { ... }(),里面发生 panic,主 handler 的 recover 完全捕获不到。这是最常被忽略的静默崩溃点。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
例如异步上报指标、后台清理缓存、发通知邮件等场景,一旦出错就消失无踪:
go func() {
// ❌ 这里的 panic 永远不会被外层 recover 捕获
riskyDBOperation()
}()
必须在 goroutine 内部自己包一层:
go func() {
defer func() {
if r := recover(); r != nil {
log.Printf("async panic: %v", r)
// 可选:写入 error channel、触发告警、上报 metrics
}
}()
riskyDBOperation()
}()
- 不能只写
func() { ... }()(那是函数值),必须是立即执行的func() { ... }() - 推荐封装为工具函数,比如
GoWithRecover(ctx, fn, errCh),统一日志格式和错误通道上报 - recover 后建议记录完整堆栈:
log.Printf("panic: %v\n%v", r, debug.Stack()),否则只看到 panic 值,难定位
避免用 panic 替代 error,尤其在线上 handler 中
很多开发者图省事,在业务逻辑里写 panic("user not found"),再靠 recover 转成 404。这违背 Go 错误哲学,也埋下隐患:
- panic 是为不可恢复的灾难设计的(如初始化失败、断言失败、内存耗尽),不是业务错误的快捷键
- 字符串 panic 无法类型判断,recover 后只能做字符串匹配(如检查是否含 "404:"),脆弱且易错
- nil、int、struct{} 等 panic 值会让 recover 分支逻辑失控,比如
if r.(string) == "xxx"直接 panic
真正可预期的业务错误(如参数校验失败、资源不存在、权限不足),应该走显式 error 返回路径:
func userHandler(c *fiber.Ctx) error {
id := c.Params("id")
if id == "" {
return c.Status(400).JSON(fiber.Map{"error": "id required"})
}
u, err := findUser(id)
if err != nil {
if errors.Is(err, ErrNotFound) {
return c.Status(404).JSON(fiber.Map{"error": "user not found"})
}
return c.Status(500).JSON(fiber.Map{"error": "internal error"})
}
return c.JSON(u)
}
只有当程序状态已损坏、继续运行风险极高时(比如配置加载失败、关键依赖未注入),才考虑 panic,且应放在初始化阶段,而非每次请求中。

















