gin路由无生命周期概念，仅启动时构建一次且全程只读；routergroup需用花括号包裹子路由以确保路径拼接正确，传入gin.engine会导致前缀失效，必须传gin.routergroup才能继承前缀与中间件。
Gin 的路由没有“生命周期管理”这个概念——它不启动、不运行、不关闭，只在启动时构建一次，之后全程只读。所谓“管理”，其实是控制路由注册时机、路径拼接逻辑和中间件嵌套顺序。
RouterGroup 必须用花括号包裹子路由
这是最常踩的坑：写 r.Group("/api/v1").GET("/users", handler) 看似合理，实际注册的是 /users，不是 /api/v1/users。因为 .GET() 没有链式调用，Go 会丢弃前半段返回值。
正确做法是显式使用花括号块：
r := gin.New()
v1 := r.Group("/api/v1")
{
v1.GET("/users", getUsers)
v1.POST("/users", createUser)
}
- 花括号不是风格问题，而是 Go 作用域 + Gin 内部实现共同决定的
-
Group()本身不注册任何路由，只构造一个带前缀和中间件上下文的容器 - 所有
.GET()、.POST()调用都必须绑定到该*gin.RouterGroup实例上
分组中间件顺序直接影响执行时机
Gin 中间件按“洋葱模型”嵌套执行：全局中间件最外层，分组中间件次之，路由 handler 最内层。顺序错，panic 就捕获不到。
比如你写了：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
r.Use(Recovery()) // 全局
admin := r.Group("/admin", AuthMiddleware())
admin.Use(LogMiddleware())
admin.GET("/dashboard", handler)
执行顺序是：Recovery() → AuthMiddleware() → LogMiddleware() → handler。
- 如果
AuthMiddleware()内部 panic，Recovery()能捕获；但如果把Recovery()放在分组里，就捕获不到 -
r.Group("/admin", m1, m2)和g.Use(m1).Use(m2)效果一致，但和全局Use()叠加后，顺序不能靠“后注册优先”来猜 - 多个嵌套分组时，父组中间件一定先于子组中间件执行
抽离路由文件时传参类型不能写错
把 /admin 路由单独拆到 admin/routes.go，函数签名写成 func InitAdminRoutes(r *gin.Engine) 是错的——这会让所有路由注册到根引擎，丢失前缀和中间件上下文。
正确方式是接收 *gin.RouterGroup：
func InitAdminRoutes(rg *gin.RouterGroup) {
rg.GET("/dashboard", dashboardHandler)
rg.POST("/settings", updateSettingsHandler)
}
// main.go 中调用：
admin := r.Group("/admin", AuthMiddleware())
InitAdminRoutes(admin)
- 传
*gin.Engine→ 所有路由变成根路径，前缀失效 - 传
*gin.RouterGroup→ 路径自动拼接，中间件上下文继承 - 模块化拆分时，每个业务模块的初始化函数都应遵循这一约定
真正需要关注的不是“生命周期”，而是路由树构建完成后的不可变性，以及中间件和分组如何协同决定每次请求的执行栈深度。一旦注册完成，路径匹配就是纯查找操作，没有运行时动态管理一说。
