StrictRouting开启时,/users和/users/被视为两个不同路由,因末尾斜杠具语义差异;注册/app.Get("/users", h)后访问/users/直接404,不进入路由树。

StrictRouting开启时,/users和/users/为什么算两个路由
Fiber 默认启用 StrictRouting: true,路径末尾斜杠被视为语义差异。注册了 app.Get("/users", handler),访问 /users/ 就是 404——不是没匹配上,是压根不进路由树。这不是 bug,是 Fiber 对路径契约的严格执行。
常见翻车点:
- 前端 SDK 或 Postman 里写了带尾斜杠的 URL,后端却只注册无斜杠版本
- 用 Nginx 反向代理时自动补了
/,比如proxy_pass http://backend/;会把/api改成/api/ - 关掉
StrictRouting: false试图“修复”,结果引发更隐蔽的参数丢失:同时注册/users和/users/:id后,/users/123可能被前者捕获,c.Params("id")拿不到值
正确做法是统一收口:app.Use(func(c *fiber.Ctx) error { if strings.HasSuffix(c.Path(), "/") && c.Path() != "/" { return c.Redirect(strings.TrimSuffix(c.Path(), "/"), 301) } return c.Next() }),把所有尾斜杠请求 301 跳转到标准形式。
路径参数和通配符混用导致 invalid pattern 错误
写 app.Get("/files/:user/*path", handler) 会启动失败,报错 invalid pattern。Fiber 的路由解析器不允许通配符 * 出现在非末尾位置,也不允许和参数节点(如 :user)共存于同一段路径中。
真正合法的写法只有三种:
-
/users/:id—— 单段参数,推荐用于 ID、slug 等固定结构 -
/static/*—— 通配符必须在末尾,且前面不能有参数节点 -
/api/:version/users/:id—— 多级参数,全部显式声明,不依赖通配
别为了“省事”写 /v1/:id/*,它既不生效也不报运行时错误,而是在 fiber.New() 启动时直接 panic。调试时注意看服务是否根本没起来,而不是查 404 日志。
Group前缀没写进子路由路径,导致匹配失效
app.Group("/api") 返回的是一个新 *fiber.Router 实例,它**不自动拼接前缀**。写 api := app.Group("/api"); api.Get("/users", h),实际匹配的是 GET /users,不是 /api/users——因为 Get 第一个参数是完整路径,Fiber 不做字符串拼接。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
容易踩的坑:
- 复制粘贴时漏掉前缀:
api.Get("/api/users", h)→ 匹配/api/api/users,多了一层 - 用变量拼接但忘了加斜杠:
prefix := "api"; api := app.Group(prefix); api.Get("/users", h)→ 匹配/users,不是/api/users - 嵌套 Group 写成
v1.Group("/admin").Get("/dashboard", h)→ 最终是/admin/dashboard,不是/v1/admin/dashboard
安全写法:把前缀当常量,显式写全路径,或用函数封装:func apiRoute(r *fiber.Router) { r.Get("/api/users", h); r.Post("/api/posts", h) },再传 app 进去调用。
同路径不同方法注册顺序引发 405
Fiber 按注册顺序匹配路由,但**不按方法优先级排序**。如果先注册 app.Post("/login", h),再注册 app.Put("/login", h),两者都能正常工作;但如果只注册了 Post,却用 PUT 请求访问,就会返回 405 Method Not Allowed——说明路径存在,但方法不支持。
排查重点:
- 检查 Network 面板里请求的
Request Method是不是你认为的那个(比如写了method="put"的 HTML 表单,实际发出来仍是 POST) - 确认没在中间件里提前终止了链路:比如 CORS 中间件没处理 OPTIONS,导致跨域 PUT 请求卡在预检,浏览器只显示 OPTIONS 404/405
- 避免用
app.All()覆盖特定方法:它会拦截所有方法,但 handler 里若没判断c.Method(),就可能把 PUT 当成 GET 处理
上线前跑一遍 curl -X PUT http://localhost:3000/login 和 curl -X DELETE http://localhost:3000/user/123,比看文档更快暴露冲突点。










