Gin中路由组必须用Group创建带前缀的子路由器，而非手动拼接路径；前缀须以单个/开头、无多余斜杠，子路由路径不能重复包含前缀；中间件需显式挂载，嵌套分组不自动继承父组中间件；通配符分组与静态路径同级注册会冲突。
要在Gin中正确组织API版本、权限域或功能模块，必须用Group创建带前缀的子路由器，而不是手动拼接路径字符串；写错前缀格式或漏挂中间件，会导致接口404或裸奔。
路由组前缀怎么写才不报错
第一步：前缀字符串【必须以单个/开头】，不能省略，也不能用//或///开头。比如r.Group("/api/v1")合法，r.Group("api/v1")或r.Group("//api/v1")会导致所有子路由注册失败或匹配异常。
第二步：前缀末尾【不能有多余/】，r.Group("/api/v1/")会令v1.GET("/users")实际注册为/api/v1//users，某些Gin版本会直接拒绝该路径注册。
第三步：定义分组变量后，内部注册路由时路径必须以/开头，但不能重复包含前缀。v1 := r.Group("/api/v1") → v1.GET("/users", h) ✅，v1.GET("/api/v1/users", h) ❌（变成/api/v1/api/v1/users）。
嵌套路由组的两种写法
方法一：链式调用（适合简单场景）
直接在父组上调用Group()并立即注册：v1.Group("/admin").GET("/logs", logsHandler)，最终路径是/api/v1/admin/logs。
方法二：显式变量命名（推荐用于中大型项目）
先声明子组变量，再在其作用域内集中注册：admin := v1.Group("/admin") → admin.GET("/dashboard", dash) → admin.POST("/config", saveConfig)。这样调试时能快速定位变量作用域，避免链式过长导致panic堆栈难读。
注意：嵌套层级没有硬性限制，但三级以上（如r.Group("/v1").Group("/user").Group("/profile")）会显著降低可读性，建议拆到独立函数中管理。
中间件必须显式挂载
Gin的Group本身不携带任何中间件逻辑，哪怕你在根路由r.Use(JWTAuth())，v1组里的路由也不会自动受保护。
v1 := r.Group("/api/v1")
v1.Use(AuthMiddleware(), LoggerMiddleware()) → 这行必须写，否则所有v1下路由都裸奔。
嵌套时中间件只向下生效：v1.Use(A()) → admin.Use(B()) → admin.GET("/x", h)，请求流是A→B→h；但v1下的其他子组（如v1.Group("/order")）不会自动获得B。
如果忘了在admin组调用Use()，而只在v1组挂了AuthMiddleware，那/admin下的路由就只有AuthMiddleware生效，缺了B——这容易导致日志缺失或权限校验漏掉关键字段。
避免通配符与静态路径冲突
别在带路径参数的组里注册同级静态路由。比如g := r.Group("/api/:version") → g.GET("/users", h) ✅，但g.GET("/api/v1/users", h) ❌，Gin会报panic: wildcard route conflicts with existing children。
正确做法是把版本号作为固定前缀分组：v1 := r.Group("/api/v1") → v1.GET("/users", h)，完全避开通配符解析歧义。
通配符组适用于需要动态提取参数的场景（如/api/:service/:action），但日常API版本控制强烈推荐用静态前缀分组。
