Fiber默认404不显示自定义内容,因其硬编码返回"Cannot GET /xxx"且绕过中间件;必须用app.Use("*", handler)在所有路由后注册通配符中间件,并显式调用c.Status(404)。

为什么默认404页面不显示自定义内容
Fiber 默认的 404 响应是纯文本 "Cannot GET /xxx",不走任何中间件或路由处理逻辑——它发生在所有路由匹配失败后、框架内部硬编码返回的兜底响应。这意味着你写的 app.Use() 或 app.Get("/404") 都不会生效。
必须用 app.Use("*", handler) 捕获未匹配路由
这是唯一可靠的方式:用通配符中间件捕获所有未被前面路由匹配的请求,并在其中手动设置状态码和响应体。注意顺序——它必须放在所有 app.Get()、app.Post() 等之后,否则会提前截断正常路由。
常见错误现象:
– 把 app.Use("*", ...) 放在最前面 → 所有请求都进 404
– 返回时忘了调用 c.Status(404) → 响应码仍是 200
– 在 handler 中 panic 或未 return → Fiber 可能继续执行后续中间件
实操建议:
立即学习“go语言免费学习笔记(深入)”;
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 始终将
app.Use("*", func(c *fiber.Ctx) error { c.Status(404).SendFile("public/404.html") })放在注册完所有业务路由之后 - 若用
SendString(),记得设Content-Type: text/html,否则浏览器可能不渲染 HTML - 避免在该 handler 中调用
c.Next()—— 它没有“下一个”路由可走了
静态文件服务开启后,SendFile 路径容易出错
Fiber 的 SendFile() 是按 Go 进程当前工作目录解析路径的,不是按 Static() 配置的根路径。比如你用 app.Static("/static", "./assets"),但 SendFile("assets/404.html") 仍需确保文件真实存在于运行时的 ./assets/404.html(而非 ./public/404.html)。
性能与兼容性影响:
– SendFile() 底层用 http.ServeFile,支持 range 请求和缓存头,比 SendString() 更适合 HTML 文件
– 若文件不存在,SendFile() 会 panic,务必加 os.Stat 检查或用 SendStatus(404) 回退
示例片段:
app.Use("*", func(c *fiber.Ctx) error {
if _, err := os.Stat("public/404.html"); err == nil {
return c.Status(404).SendFile("public/404.html")
}
return c.Status(404).SendString("<h1>Page Not Found</h1>")
})
模板引擎(如 html)下如何动态渲染 404
如果你已配置了 fiber.New(fiber.Config{Views: ...}),可以直接用 c.Render(),但要注意:模板名不带扩展名,且路径相对于 Views 目录。比如 Views: "./templates",那么 404.html 应放在 ./templates/404.html,调用时写 c.Render("404", fiber.Map{})。
容易踩的坑:
– 模板中引用的 CSS/JS 路径是相对当前 URL 的,不是相对模板路径 → 推荐用绝对路径 /static/css/main.css
– Render() 不自动设状态码,必须显式 c.Status(404)
– 若模板解析失败(如语法错误),会返回 500 而非 404,线上环境建议加 recover 中间件兜底

















