Fiber中POST路由必须严格匹配“方法+完整路径”,未注册、路径缺/、大小写不符或未处理OPTIONS预检均导致404;Content-Type决定解析方式,参数来源(Params/QueryParam/Header)相互隔离。

POST 路由必须显式注册,不自动 fallback 到其他方法
Fiber 不会把未注册的 POST 请求转给 GET 或其他方法处理——没写 app.Post(),就是 404;写了但路径少个 / 或大小写不对,也是 404。它严格按「方法 + 完整路径」双匹配,不猜测、不容错。
常见错误现象:
- 前端发
POST /api/users,后端只写了app.Post("api/users", ...)(缺前导/)→ 404 - 路由写成
app.Post("/API/users", ...),但请求是小写/api/users→ 默认不忽略大小写,404(除非启用CaseSensitive: false) - 用 HTML 表单提交,
method="post"正确,但action指向了没注册的路径 → 404,不是前端问题
如何正确读取 POST 请求体:看 Content-Type 决定用哪个方法
Fiber 不自动解析请求体,Content-Type 是分水岭。你得自己选对方法,否则 c.BodyParser() 返回空或报错,c.FormValue() 拿不到 JSON 字段。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
-
Content-Type: application/json→ 用c.BodyParser(&v),结构体字段需带json:tag -
Content-Type: application/x-www-form-urlencoded或multipart/form-data→ 用c.FormValue("key"),不能用BodyParser -
Content-Type: text/plain或无类型 → 用c.Body()拿原始字节,再手动解码 - 混用查询参数和表单数据?
c.QueryParam("page")和c.FormValue("name")各取各的,互不影响
POST 路由里怎么取路径参数、查询参数和 Header
三类参数完全隔离,命名和来源都不同,不会自动合并或覆盖。
- 路径参数(如
/user/:id中的id)→c.Params("id"),仅从路径提取 - 查询参数(
?token=abc&limit=10)→c.QueryParam("token"),推荐这个,比c.Query()更安全(缺失 key 返回空字符串) - Header(如
Authorization: Bearer xxx)→c.Get("Authorization"),注意大小写不敏感,但键名要写对 - 别试图用
c.Params("token")去拿 query string 里的token=,它永远为空
为什么 POST 请求返回 405 Method Not Allowed
这不是 POST 本身的问题,而是你注册的路由和实际请求方法不一致。405 的意思是“路径存在,但方法不支持”。
- 只注册了
app.Get("/submit"),却用 POST 访问 → 405 - 注册了
app.Post("/submit"),但前端发的是 PUT → 405 - 跨域场景下,浏览器先发 OPTIONS 预检,而你没配 CORS 中间件 → OPTIONS 请求 404/405,导致后续 POST 根本发不出
- 解决办法:确认 Network 面板里 Request Method 真的是 POST;加
app.Use(cors.New())应对预检;检查是否启用了StrictRouting: true导致尾部斜杠不匹配
/、写错一个 Content-Type 分支、或混淆 Params 和 QueryParam,都会立刻暴露为 404 或空值。


















