ErrorHandler必须在fiber.New()时通过fiber.Config{ErrorHandler: fn}配置,不可后期覆盖;它仅捕获panic、*fiber.Error等运行时异常,不处理路由未匹配,且需手动设状态码并区分错误类型。

ErrorHandler 必须在 fiber.New() 时配置,不能后期覆盖
Fiber 的全局错误捕获只靠 ErrorHandler 字段,它必须通过 fiber.Config{ErrorHandler: fn} 传给 fiber.New(),注册后无法修改。写成 app.Use(...) 或 app.ErrorHandler = fn 都无效——前者是中间件,后者字段只读。
常见错误现象:加了 app.ErrorHandler = func(...) {...} 却发现 panic 还是返回空白页或 500 原始响应,就是因为没走对入口。
-
ErrorHandler是同步函数,接收*fiber.Ctx和error,必须手动设状态码(如c.Status(500)) - 它不处理路由未匹配(那是
NotFound的事),只捕获panic、fiber.NewError()或 handler 显式返回的 error - 别在
ErrorHandler里再调panic,否则二次崩溃,进程可能退出
区分 *fiber.Error 和其他 error 类型
第三方库报错(比如数据库超时、文件打开失败)通常不是 *fiber.Error,没有内置 Code 字段。如果无差别 c.Status(500),就会把本该是 404 的业务逻辑错误也打成 500,掩盖真实问题。
正确做法是类型断言:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
if e, ok := err.(*fiber.Error); ok {
c.Status(e.Code)
} else {
log.Printf("unhandled error: %v (%T)", err, err)
c.Status(500)
}
-
*fiber.Error来自fiber.NewError(404, "not found")等显式构造,e.Code可直接用 - 非
*fiber.Error类型建议记录原始 error 类型(%T),方便排查是 JSON 解析失败、还是网络 IO 超时 - 不要用
errors.Is(err, os.ErrNotExist)这类判断去映射状态码——太脆弱,应由业务层主动抛出带 Code 的*fiber.Error
JSON 错误响应要判断 Accept 头,不能硬编码 c.JSON()
前端发 Accept: application/json 时返回 JSON 没问题,但浏览器直连或 Postman 默认发 Accept: text/html,*/*,硬调 c.JSON() 就会导致 Content-Type 不匹配,前端解析失败。
安全做法是先查头再决定格式:
if c.Accepts("json") == "json" {
c.Status(500).JSON(fiber.Map{"error": "internal server error"})
} else {
c.Status(500).SendString("Internal Server Error")
}
-
c.Accepts("json")返回空字符串表示不接受,不是布尔值 - 别依赖
c.Get("Accept")手动解析,容易漏掉application/json; charset=utf-8这类变体 - 若统一走 HTML 错误页,需确保
c.Type("text/html")和c.Status()都显式设置,否则状态码可能仍是 200
panic 捕获后别丢原始堆栈,日志要含 c.Path() 和 c.Method()
Fiber 的 ErrorHandler 是 recover 后的第一道拦截,但默认只传 error 值,不带请求上下文。如果只记 log.Println(err),你根本不知道这个 panic 是来自 /api/users 还是 /health。
- 务必在日志里拼上
c.Path()、c.Method()和c.Request().URI().QueryString()(脱敏后) - 用
debug.PrintStack()或runtime/debug.Stack()获取 panic 堆栈,但注意别直接塞进响应体——可能泄露敏感路径或变量名 - 生产环境禁用
fiber.Config{DisableStartupMessage: false}以外的调试输出,避免日志刷屏
Fiber 的错误处理边界很清晰:路由未匹配走 NotFound,运行时异常走 ErrorHandler,两者缺一不可。最容易被忽略的是——你写了 fiber.NewError(404, "..."),它不会触发 NotFound,而是直接进 ErrorHandler。这点和 Express 的 next("route") 完全不同。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










