生产环境不可直接用gin.Default()，因其默认启用Logger和Recovery中间件，暴露敏感信息且panic恢复不可控；应设gin.ReleaseMode，改用http.Server自定义启动并手动注册可控中间件。
直接用 gin.Default() 启动服务，但线上跑不稳
默认启动方式 r.Run() 会启用 Logger 和 Recovery 中间件，适合开发调试，但线上环境会因日志刷屏、panic 恢复行为不可控导致监控失真或掩盖真实问题。
生产环境必须显式切换模式：
- 启动前加
gin.SetMode(gin.ReleaseMode)，关闭调试日志和堆栈输出 - 改用
http.Server自定义启动，而非r.Run()，便于控制超时、连接数、Header 大小等关键参数 - 不要依赖
gin.Default()的中间件组合；若需日志/恢复，应自己注册可控版本的中间件（比如带采样率的 recovery）
示例片段：
s := &http.Server{
Addr: ":8080",
Handler: router,
ReadTimeout: 5 * time.Second,
WriteTimeout: 10 * time.Second,
MaxHeaderBytes: 1 << 20,
}
s.ListenAndServe()
GET / POST 路由写对了，但参数始终取不到
常见错因不是路由没配，而是参数类型和获取方式不匹配。Gin 不自动解析 body 或 query，得手动调用对应方法。
-
c.Param("name")只用于路径参数，如/user/:id中的:id，不能读?id=123 -
c.Query("key")读 URL 查询参数（?key=value），c.DefaultQuery("key", "default")可设默认值 -
c.PostForm("key")读application/x-www-form-urlencoded表单，c.GetPostForm()兼容 GET+POST -
c.ShouldBindJSON(&v)绑定 JSON body，要求结构体字段有json:tag，且请求头必须是Content-Type: application/json
漏设 header 或混淆 Query / Param 是最常踩的坑，建议统一打日志验证原始输入：c.Request.URL.String() 和 c.Request.Header.Get("Content-Type")
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
想支持 RESTful 风格路由，但 PUT / DELETE 请求被拦截或 405
Gin 本身完全支持所有标准 HTTP 方法，405 错误几乎都来自外部因素。
- 前端发
PUT/DELETE时，浏览器会先发OPTIONS预检请求；若后端没配router.OPTIONS()或没开 CORS，预检失败就卡住 - Nginx / Apache 等反向代理默认可能禁用非 GET/POST 方法，需检查配置里是否有
limit_except或类似限制 - 某些测试工具（如旧版 curl）不显式指定 method 时会 fallback 到 GET，要用
curl -X PUT显式声明
快速验证：用 curl -X PUT http://localhost:8080/api/user/123 -H "Content-Type: application/json" -d '{"name":"a"}' 直连服务，绕过代理和浏览器
路由分组后中间件不生效，或 router.Group() 嵌套混乱
router.Group() 返回的是新子路由对象，不是原 router，所有注册必须链在它后面。
- 错误写法：
g := router.Group("/api"); g.GET("/v1/users", handler); router.POST("/login", handler)—— 后者注册到根路由，不在/api下 - 正确写法：所有该组下的路由都必须用
g注册，且嵌套分组要逐级接续：g.V1 := g.Group("/v1"); g.V1.GET("/users", ...) - 中间件只作用于注册它的那个 Group 及其子 Group，父 Group 的中间件不会自动继承给子 Group，除非显式传入
复杂项目建议按业务域拆分 Group，并把中间件定义成变量复用，避免重复写 g.Use(auth, logging)
路由本质是路径 + 方法的精确匹配，Gin 的 httprouter 底层不支持正则、不支持通配符模糊匹配，所有“看似灵活”的行为（比如 /*action）其实都是固定前缀树匹配，这点容易被文档误导。
