StrictRouting 导致 /users 和 /users/ 均 404，需显式注册两者或用中间件重定向；Use 前缀匹配要求严格路径边界；Params/QueryParam/BodyParser/ FormValue 来源不同不可混用；Group 和 Static 在 API 服务中应避免，静态资源交由 Nginx 或 CDN 托管。
StrictRouting 导致 /users 和 /users/ 都 404 怎么办
这是上线后最常被误判为“框架 bug”的问题。Fiber 默认 StrictRouting: true，意味着 /users 和 /users/ 是两条完全独立的路由，注册一个不会自动匹配另一个。
别关 StrictRouting——虽然加 fiber.Config{StrictRouting: false} 能让两者都命中，但会破坏路径参数提取逻辑：比如你同时注册了 /users 和 /users/:id，关掉 StrictRouting 后，/users/123 可能被前者捕获，c.Params("id") 拿不到值。
- 显式注册两个路径：
app.Get("/users", handler)和app.Get("/users/", redirectHandler) - 或统一重定向：在中间件里判断
strings.HasSuffix(c.Path(), "/") && c.Path() != "/"，然后c.Redirect(strings.TrimSuffix(c.Path(), "/"), 301) - 上线前检查所有客户端调用（Postman、OpenAPI spec、前端 SDK）是否已统一使用无尾斜杠路径
app.Use() 前缀匹配不生效？检查路径边界
app.Use("/api", middleware) 不是“只要 URL 包含 /api 就触发”，而是严格前缀匹配，且要求后跟 / 或路径结束。它对所有 HTTP 方法生效，底层会复制到每个方法栈。
常见失效场景：
-
app.Use("/api", m)→ 匹配/api、/api/users、/api/v1/health -
app.Use("/api", m)→ 不匹配/apixxx、/api123、/api?x=1（query string 不参与匹配） - 若想匹配
/api和/api/，需写成app.Use("/api", m)+app.Use("/api/", m)，或统一用重定向中间件收口
ctx.Params()、ctx.QueryParam()、ctx.BodyParser() 别混用
三者来源完全不同，同名参数不会自动合并，也不会互相覆盖。混淆是 500 错误和空字段的高频原因。
典型错误：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 请求 URL 是
/user/123?format=json，却用c.QueryParam("id")试图取123→ 实际应调c.Params("id") - POST JSON body 里有
{"name": "alice"}，却用c.QueryParam("name")或c.FormValue("name")→ 必须用c.BodyParser(&v) - 表单提交
application/x-www-form-urlencoded，却用c.BodyParser→ 应改用c.FormValue("name")
记住：路径占位符 → c.Params()；查询字符串 → c.QueryParam()；JSON body → c.BodyParser()；表单 → c.FormValue()。
为什么不用 app.Group() 和 app.Static()？
这两个 API 在纯 API 服务中属于高开销操作，且与生产部署习惯冲突。
app.Group() 内部做路径拼接、前缀预处理、嵌套中间件栈拷贝；app.Static() 则触发文件系统探测、MIME 类型推导、压缩协商、缓存头生成等——全是 CPU 和 I/O 开销，而你的静态资源本该由 Nginx 或 CDN 托管。
- 嵌套路由手写完整路径：
app.Get("/api/v1/users", handler)，别写api := app.Group("/api/v1"); api.Get("/users", handler) - 静态资源交给反向代理：Nginx 配置
location /static { alias /var/www/static; }，Fiber 中彻底删掉app.Static() - 真要复用前缀逻辑，自己封装函数：
func registerV1(api fiber.Router) { api.Get("/users", userHandler) }，不依赖框架 Group 机制
Group 和 Static 的便利性是以运行时开销换来的，生产环境宁可多敲几行字，也不让每条请求多走一次路径解析。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
