如何在Fiber框架中自定义错误响应-Golang-PHP中文网

最常见原因是未显式调用c.status(404)或c.status(500)，fiber默认返回200；且notfound仅在无匹配路由时触发，需通过fiber.config配置，而非普通路由注册。

如何在fiber框架中自定义错误响应

为什么自定义错误响应总返回 200 状态码

最常见原因是：你在 NotFound 或 ErrorHandler 里只写了 HTML 渲染或字符串输出，却忘了调用 c.Status(404) 或 c.Status(500)。Fiber 不会自动根据内容推断状态码，c.SendString("not found") 默认发的是 200。

另一个隐蔽坑是：用了 app.Get("/404", ...) 这类路由，误以为访问不存在路径会跳过去——实际完全不触发，因为 404 是“无匹配路由”时才走的兜底逻辑，不是普通路由。

必须在 fiber.New(fiber.Config{...}) 初始化时传入 NotFound 和 ErrorHandler，后期调用 app.Use(...) 无法覆盖
NotFound 只处理“没注册任何路由”的情况；ErrorHandler 才捕获 panic、显式 fiber.NewError(500, "") 等异常
浏览器缓存可能导致你改了代码但页面还是旧的，测试时用无痕模式或加时间戳参数（如 /test?_t=123）

如何正确配置 NotFound 和 ErrorHandler

NotFound 是纯函数，接收 *fiber.Ctx，推荐直接返回静态内容；ErrorHandler 多一个 error 参数，需手动判断错误类型再设状态码。

NotFound 示例：

NotFound: func(c *fiber.Ctx) error {
  c.Status(404)
  return c.SendString("<h1>⛔ 页面未找到</h1>")
}

ErrorHandler 示例（区分 404 和 500）：

ErrorHandler: func(c *fiber.Ctx, err error) error {
  if e, ok := err.(*fiber.Error); ok {
    c.Status(e.Code)
  } else {
    c.Status(500)
  }
  return c.SendString("<h1>" + c.Response().StatusCode() + " 错误</h1>")
}

二者可共存：比如用户访问 /api/user/999，路由存在但 DB 查不到数据，应由业务 handler 主动返回 fiber.NewError(404, "user not found")，这样会进 ErrorHandler 而非 NotFound

用模板引擎渲染错误页时怎么避免 panic

如果你已配好 html.New() 模板引擎，不能直接在 NotFound 里写 c.Render("404", nil)——因为 Render 是异步方法，而 NotFound 是同步 handler，出错时没法 recover。

Fiber框架 3.0.0

Fiber框架 3.0.0 版本源码包下载，适合从 Fiber v2 迁移到 v3、体验新绑定系统、HTTP 客户端、状态管理和迁移工具的开发者。

下载

必须手动捕获 Render 错误，并 fallback：

NotFound: func(c *fiber.Ctx) error {
  c.Status(404)
  if err := c.Render("404", nil); err != nil {
    return c.SendString("404 page not found")
  }
  return nil
}