gin.Default()默认启用Logger和Recovery中间件，适合开发调试；生产环境应改用gin.New()以自定义中间件提升可控性与安全性。
gin.Default() 创建的引擎默认带 Logger 和 Recovery 中间件，适合开发调试；生产环境若需精简中间件或自定义行为，应改用 gin.New()。
如何注册标准 HTTP 方法路由（GET/POST/PUT/DELETE）
每个方法对应一个同名函数，路径和处理函数是必填参数，签名统一为 func(*gin.Context)：
-
r.GET("/users", handler)用于获取资源列表或详情 -
r.POST("/users", handler)用于创建新资源，注意 body 解析需手动调用c.ShouldBindJSON()或类似方法 -
r.PUT("/users/:id", handler)全量更新，通常要求提供完整字段 -
r.DELETE("/users/:id", handler)删除指定 ID 资源
常见错误：把 POST 和 PUT 混用，或在 GET 处理函数里尝试读取 request body（Go 的 http.Request.Body 在 GET 中为空且不可重读）。
路由分组（Group）怎么用才不踩坑
分组不是语法糖，它影响路径拼接、中间件作用域和代码可维护性。关键点：
- 前缀自动拼接：写
v1 := r.Group("/v1")后，v1.GET("/login")实际注册的是/v1/login，不是/login - 中间件只对组内生效：如
admin := r.Group("/admin", authMiddleware)，authMiddleware不会作用到r.GET("/health") - 嵌套组时前缀叠加：
v2.Group("/admin").GET("/dashboard")对应路径是/v2/admin/dashboard
容易忽略：分组变量本身不保存中间件引用，如果中间件需要动态配置（比如不同版本用不同 JWT 密钥），得在分组内部显式传参或闭包捕获。
Any() 和 NoRoute() 的真实用途
这两个方法解决的是「兜底」问题，不是常规路由手段：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
r.Any("/api/*path", proxyHandler)可用于反向代理或网关层透传，匹配所有方法 + 任意子路径，但要注意它会覆盖后续更具体的路由（注册顺序敏感） -
r.NoRoute(func(c *gin.Context) { c.String(404, "not found") })必须放在所有GET/POST等注册之后，否则永远不会触发 - 误用
Any()替代 RESTful 设计会导致接口语义混乱，比如用Any("/user")处理所有操作，丢失 HTTP 方法语义和缓存能力
性能提示：NoRoute() 是线性查找失败后的最后 fallback，不影响正常路由匹配速度；但 Any() 会参与每次匹配，路径越靠前越早命中，建议仅用于明确需要通配的场景。
启动前必须检查的三件事
很多「路由不生效」问题其实发生在运行前：
- 确认
r.Run()调用在所有路由注册之后，且没有被return或 panic 提前中断 - 检查端口是否被占用，
r.Run(":8080")失败时会 panic，但错误信息可能被日志中间件吞掉，建议加if err := r.Run(); err != nil { log.Fatal(err) } - 路径中不要混用斜杠风格：
r.GET("user")和r.GET("/user")是两个不同路由；Gin 默认不自动补前导/，推荐统一写成/user
最隐蔽的问题：在测试中用 httptest.NewRecorder() 发起请求时，忘记设置 req.Method 或 req.URL.Path，导致看似路由注册了，实则没走任何 handler。
