fiber的404页面不生效，主要因未在fiber.new()中正确配置notfound处理器；常见原因包括：①误设/404路由而非使用notfound配置；②未调用c.status(404)导致状态码仍为200；③模板渲染未错误处理或路径错误；④修改后未重启服务或受浏览器缓存影响。
为什么 Fiber 的 404 页面总是不生效
Fiber 默认不会自动查找 views/404.html 这类文件，它不走模板路径自动匹配机制。404 触发前提是：请求路径未被任何路由注册，且中间件链中没提前返回响应。常见失效原因是：
- 你写了
app.Get("/404", ...)这类路由，误以为访问不存在路径会跳过去——实际不会，Fiber 根本不这么处理错误 - 用了
app.Use(middleware.Recover())但没配app.Use(middleware.Logger())等前置中间件，导致某些 panic 被吞掉，却没走到全局错误处理 - 自定义错误处理函数里忘了调用
c.Status(404)或直接 return，导致响应体是 HTML，但状态码仍是 200
正确注册 NotFound 和 ErrorHandler
Fiber 提供两个核心配置点：fiber.Config{NotFound: ...} 控制纯 404（无匹配路由），fiber.Config{ErrorHandler: ...} 捕获 panic 和未处理异常（含 500 场景）。必须在 fiber.New() 初始化时传入，不能后期覆盖。
-
NotFound是一个fiber.Handler，推荐直接返回静态 HTML 字符串或调用c.SendString()：app := fiber.New(fiber.Config{ NotFound: func(c *fiber.Ctx) error { c.Status(404) return c.SendString("<h1>⛔ 页面未找到</h1>") }, }) -
ErrorHandler接收error参数，需手动判断类型来区分 404 和 500：ErrorHandler: func(c *fiber.Ctx, err error) { if _, ok := err.(*fiber.Error); ok { c.Status(err.(*fiber.Error).Code) } else { c.Status(500) } c.SendString("<h1>" + c.Response().StatusCode() + " 错误</h1>") } - 二者可共存：
NotFound处理“路由未注册”，ErrorHandler处理“路由内 panic”或显式fiber.NewError(500, "...")
用模板引擎渲染自定义页面（如 HTML 文件）
如果你已配置了 html.New() 模板引擎，不能直接在 NotFound 中写 c.Render("404", nil)——因为 Render 是异步的，而 NotFound 是同步 handler，必须自己处理错误。
- 安全做法：在
NotFound函数里捕获Render错误，并 fallback 到纯文本：NotFound: func(c *fiber.Ctx) error { c.Status(404) if err := c.Render("404", fiber.Map{}); err != nil { return c.SendString("404 - Not Found") } return nil } - 确保模板路径正确：比如用
html.New("./views", ".html")，那你的404.html必须放在./views/404.html - 注意：Fiber 不会自动加载
resources/views/errors/404.html这种 Laravel 风格路径，全由你指定
本地调试时为什么看不到自定义页面
和 Laravel、Flask 类似，Fiber 在开发阶段如果启用了调试工具（比如手动加了 fmt.Println 或用了 pprof 中间件），容易掩盖真实错误流；但更关键的是：fiber.New() 的配置一旦传入就不可变，改完代码必须重启进程。
- 常见疏漏：改了
NotFound函数但没重启服务，浏览器缓存了旧响应（尤其是 404，浏览器可能强缓存） - 测试方法要直接：用
curl -I http://localhost:3000/nonexistent看响应头Status是否为404，而不是只看页面内容 - 500 场景建议主动触发：
app.Get("/panic", func(c *fiber.Ctx) error { panic("test 500") })，避免依赖偶然错误
Fiber 的错误处理是显式、低封装的，没有“约定优于配置”的自动发现逻辑。最容易被忽略的点是：NotFound 和 ErrorHandler 必须在 fiber.New() 时一次性注入，且两者职责严格分离——前者管路由层，后者管执行层，混用或后期 patch 都无效。
