Group 是 Gin 多层级路由嵌套的唯一合法入口，需严格遵循前缀格式（单斜杠开头、无尾随斜杠），中间件不自动继承，通配符路由必须注册在根 r 上且不可与静态路径同级共存。
Group 是 Gin 实现多层级路由嵌套的唯一合法入口，不是语法糖，而是路由树构建的核心机制；写错前缀格式、漏挂中间件、路径重复拼接，都会直接导致 404 或中间件失效。
路由前缀必须严格满足「单斜杠开头、无尾随斜杠」
前缀字符串是 Group() 的第一参数，它决定子路由的完整路径基底，但 Gin 不做任何标准化处理——你给什么，它就拼什么。
-
r.Group("/api/v1")✅ 注册v1.GET("/users", h)→ 实际路径为/api/v1/users -
r.Group("api/v1")❌ 缺少开头/，Gin 会把整个路径当相对路径处理，最终匹配失败或行为未定义 -
r.Group("/api/v1/")❌ 末尾多一个/，v1.GET("/users", h)会被注册为/api/v1//users，部分 Gin 版本（如 v1.9+）会直接 panic 报错invalid path
嵌套层级超过两级时，必须拆到独立函数中管理
链式调用如 r.Group("/v1").Group("/user").Group("/profile").GET("/info", h) 虽语法合法，但调试时堆栈难定位、IDE 自动补全易中断、代码 review 时无法快速识别模块边界。
- 推荐方式：每个业务域（如 user、order、admin）单独抽成函数，接收
*gin.RouterGroup参数 - 示例：
func registerUserRoutes(rg *gin.RouterGroup) { rg.GET("", list); rg.POST("", create); rg.GET("/:id", get) } - 调用：
user := v1.Group("/users"); registerUserRoutes(user) - 好处：单元测试可直接传入 mock
RouterGroup，不依赖完整gin.Engine
中间件不会自动继承，嵌套组必须显式 Use()
Group 本身不携带中间件逻辑，父组挂的中间件只对父组内直系路由生效，子组完全隔离。这是最容易被忽略的权限裸奔点。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
v1 := r.Group("/api/v1"); v1.Use(AuthMiddleware()); admin := v1.Group("/admin")→admin下所有路由**不经过**AuthMiddleware - 正确写法：
admin := v1.Group("/admin"); admin.Use(AuthMiddleware(), LoggerMiddleware()) - 若需共享中间件，建议封装为变量：
commonMW := []gin.HandlerFunc{AuthMiddleware(), LoggerMiddleware()}，再在各组中统一Use(commonMW...) - 注意：通配符路由（如
GET("/*path", fallback)）必须注册在最外层r上，不能放在任意Group内，否则前缀会导致匹配失效
静态路径与通配符分组不能同级共存
当一个 Group 同时包含静态子路径（如 /users）和通配符子组（如 Group("/*any")），Gin 的路由匹配器会因前缀冲突拒绝注册，或导致 404 随机出现。
- 错误示例：
v1 := r.Group("/api/v1"); v1.GET("/health", health); v1.Group("/*any").GET("", catchAll) - 根本原因：
/*any是模糊前缀，Gin 无法确定/health是否应优先匹配该通配符组 - 解决方式：通配符路由必须放在根
r上，且只能存在一个；业务分组全部走明确前缀，如v1.Group("/users")、v1.Group("/posts") - 补充：若真需 fallback 行为，用
r.NoRoute()更安全，它不参与前缀匹配，只兜底未命中任何路由的请求
多层级嵌套真正的复杂点不在语法，而在中间件作用域的显式声明和通配符的排他性约束——这两处一旦出错，问题往往延迟暴露，直到上线后某类请求突然 404 或跳过鉴权。
