fiber本身不强制restful风格，但可通过app.get、app.post、app.put、app.delete配合路径参数（如/users/:id）和资源中心设计实现标准restful路由；应避免/user/add等动词式路径，统一用http方法表达crud意图，并推荐使用group分组管理多资源路由。
Fiber 本身不强制 RESTful 风格，但通过合理组织 app.Get、app.Post、app.Put、app.Delete 和路径参数，可以干净地实现标准 RESTful 路由。关键不是“配置开关”，而是按资源建模、统一路径前缀、正确使用 HTTP 方法。
怎么写符合 RESTful 规范的路由定义
不要把 CRUD 拆成 /user/add、/user/delete?id=123 这类非 RESTful 写法。应以资源为中心，用 HTTP 方法表达意图：
-
GET /users→ 列表（可带?page=1&limit=10） -
GET /users/:id→ 单个资源（:id是路径参数） -
POST /users→ 创建（请求体含 JSON） -
PUT /users/:id→ 全量更新（客户端提供完整对象） -
PATCH /users/:id→ 部分更新（更安全，推荐） -
DELETE /users/:id→ 删除
示例代码片段：
app.Get("/users", handler.ListUsers)
app.Get("/users/:id", handler.GetUser)
app.Post("/users", handler.CreateUser)
app.Put("/users/:id", handler.UpdateUser)
app.Delete("/users/:id", handler.DeleteUser)
注意：:id 是 Fiber 的路径参数语法，不是字符串字面量；handler 是你自定义的函数，需接收 *fiber.Ctx。
为什么 :id 必须是路径参数而不是 query 参数
RESTful 强调「资源标识即 URI」。/users/123 表示 ID 为 123 的用户这个资源；而 /users?id=123 把它降级为一个查询条件，语义模糊，也破坏了幂等性（比如 DELETE /users?id=123 不符合规范，且无法被反向代理或 CDN 正确缓存）。
- 路径参数
:id由 Fiber 自动解析到c.Params("id")，类型是string，需手动转int64或uuid.UUID - query 参数（如
c.Query("page")）只用于过滤、分页、排序等非核心标识场景 - 混用（比如
GET /users/:id?include=profile）是允许的，但:id不能丢
常见错误：没做路径层级收敛，导致路由散乱
新手常写成：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
app.Get("/getUser/:id", handler.GetUser) // ❌
app.Post("/createUser", handler.CreateUser) // ❌
app.Delete("/removeUser/:id", handler.DeleteUser) // ❌
这完全违背 RESTful 原则，也难维护。正确做法是：
- 所有用户相关路由统一前缀
/users，靠方法区分行为 - 嵌套资源用斜杠层级，例如
GET /users/:id/posts、POST /users/:id/posts - 避免在路径中出现动词（
get、create、delete），HTTP 方法已承担该职责
如果项目有多个资源（posts、comments），建议用 app.Group() 分组管理：
users := app.Group("/users")
users.Get("", handler.ListUsers)
users.Get("/:id", handler.GetUser)
users.Post("", handler.CreateUser)
users.Put("/:id", handler.UpdateUser)
users.Delete("/:id", handler.DeleteUser)
容易忽略的细节：404 和 405 处理
Fiber 默认对未注册的路径返回 404，但不会自动拒绝错误方法（比如对 /users/:id 发起 POST）。这意味着：
- 如果你只注册了
app.Get("/users/:id")，但没注册app.Post("/users/:id")，Fiber 会直接 404 —— 这其实是 OK 的，因为该路径下不该支持 POST - 但若你希望明确返回 405（Method Not Allowed），需手动加中间件或在 Group 中统一处理
- 更现实的问题是：路径参数校验失败（比如
/users/abc中abc无法转成整数），这时业务逻辑里要早 return 400，别让后续 DB 查询 panic
真正容易踩的坑，是把「能跑通」当成「符合规范」—— 路由结构松散、参数位置随意、方法滥用，后期加 OpenAPI 文档、前端 Axios 封装、网关路由策略时，会立刻暴露问题。RESTful 不是语法糖，是接口契约。
