r.post() 是 gin 注册 post 路由的刚性接口，必须使用；它自动启用 content-type 识别与默认绑定器，而 r.handle("post", ...) 会绕过该机制导致解析失败；表单用 c.postform()，json 必须用 c.shouldbindjson()；分组路由需通过 group 实例调用（如 api.post()），不可漏写前缀；gin.new() 需手动添加 gin.recovery() 防止 panic 致服务静默崩溃。
r.POST() 是 Gin 中注册 POST 路由的最直接方式，但实际使用中容易因请求体格式、参数解析逻辑或中间件顺序出错，导致 400、空值或 panic。
POST 路由注册必须用 r.POST()，不能用 r.Handle("POST", ...) 替代
虽然 r.Handle() 支持任意方法，但 r.POST() 内部做了关键处理：自动启用 Content-Type 自动识别和默认绑定器（如 form、json 的预判）。直接用 r.Handle("POST", ...) 会绕过这些机制，导致 c.ShouldBind() 失败或 c.PostForm() 返回空。
-
r.POST("/login", loginHandler)✅ 正确，启用完整绑定流程 -
r.Handle("POST", "/login", loginHandler)❌ 可能丢弃原始Content-Type判断逻辑
c.PostForm() 只能读 application/x-www-form-urlencoded 和 multipart/form-data
这是最容易踩的坑：前端发 application/json，后端却调用 c.PostForm("user")，结果永远是空字符串。Gin 不会跨格式自动转换。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 表单提交（HTML
<form method="post"></form>）→ 用c.PostForm("key") - AJAX 发
Content-Type: application/json→ 必须用c.ShouldBindJSON(&v)或c.GetRawData()手动解析 -
c.DefaultPostForm("key", "default")仅对上述两种类型生效，对 JSON 无效
路由分组下 POST 必须显式写在 .Group() 块内
分组前缀不会自动继承到 POST 方法调用上；如果漏掉 api.POST(...) 中的 api.，路由会注册到根引擎，而非分组路径。
api := r.Group("/api/v1")
api.POST("/users", createUser) // ✅ 注册为 /api/v1/users
r.POST("/users", createUser) // ❌ 注册为 /users，脱离分组
- 分组变量名（如
api）不是语法糖，而是独立的*gin.RouterGroup实例 - 所有子路由必须通过该实例调用
POST、GET等方法
没有中间件时，POST 路由也能工作，但生产环境必须检查 gin.Recovery() 是否启用
gin.Default() 默认包含 Recovery 和 Logger，但如果用 gin.New() 自建引擎，忘记加 Recovery，遇到 panic 会导致整个服务挂死（HTTP 连接不响应，而非返回 500）。
-
r := gin.Default()→ 安全，开箱即用 -
r := gin.New()→ 必须手动r.Use(gin.Recovery())，否则 POST 出 panic 就静默失败 - 测试时用
curl -X POST http://localhost:8080/xxx配合-v查看状态码是否真实返回
r.POST()，而是请求头、数据格式、分组作用域和 panic 恢复这四点没对齐——任何一个错位，POST 就“看起来没反应”。
