Group路径前缀必须以/开头且末尾不加/，如r.Group("/api/v1")；嵌套分组自动叠加前缀，变量路由照常定义；空字符串前缀不推荐；中间件需显式挂载，顺序执行且必须调用c.Abort()中断流程。
Group路径前缀怎么写才不会出错
路径前缀必须以 / 开头，且不能多加或少加斜杠。比如要定义 /api/v1 下的所有路由，就该写 r.Group("/api/v1")；写成 r.Group("api/v1")（缺开头斜杠）会导致匹配失败，写成 r.Group("/api/v1/")（末尾多斜杠）在某些 Gin 版本中会引发路由歧义甚至 404。
嵌套分组时，每级前缀独立叠加：v1 := r.Group("/api/v1")，再 admin := v1.Group("/admin")，那么 admin.GET("/users") 对应的完整路径就是 /api/v1/admin/users，不是 /api/v1//admin/users 或 /admin/users。
- 变量路由照常写：
v1.GET("/users/:id", getUser)→ 匹配/api/v1/users/123 - 空字符串前缀
r.Group("")合法但无意义，容易混淆，不建议用 - 不要手动拼接路径字符串——
v1.GET("/api/v1/users", ...)会变成/api/v1/api/v1/users
中间件必须显式挂载，分组不继承任何中间件
Group 本身只是带前缀的子路由器，它不携带、不继承、不自动应用任何中间件。哪怕你在 r.Use(JWTAuth()) 注册了全局鉴权，v1.Group("/api/v1") 里的路由也不会受保护。
正确做法是显式调用 .Use()：
立即学习“go语言免费学习笔记（深入）”；
v1 := r.Group("/api/v1").Use(JWTAuth(), Logging())
admin := v1.Group("/admin").Use(RoleRequired("admin"))
多个中间件按注册顺序执行：先 JWTAuth() 解析 token 并写入 c.Set("role", ...)，再 RoleRequired("admin") 读取校验。顺序反了会 panic 或跳过检查。
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
- 漏掉
c.Abort()是最危险的错误：鉴权失败后只返回 JSON 却没中断流程，后续 handler（如DeleteUser）仍会执行 -
Use()只影响当前分组及其子分组，不影响其他分组或根路由 - 全局
r.Use()和分组.Use()是叠加关系，不是覆盖
权限控制不能靠路径前缀，必须由中间件完成
路径前缀（如 /admin）本身不提供任何权限隔离能力。攻击者可以伪造请求绕过前端路由，直接调用 /api/v1/admin/users——只要没中间件校验，照样能进 handler。
典型做法是在分组上绑定 JWT 解析 + 角色校验中间件：
func RoleRequired(roles ...string) gin.HandlerFunc {
return func(c *gin.Context) {
role, ok := c.Get("role")
if !ok || !contains(roles, role.(string)) {
c.JSON(403, gin.H{"error": "forbidden"})
c.Abort() // 必须有这一句
return
}
c.Next()
}
}
然后绑定：admin := r.Group("/admin").Use(JWTAuth(), RoleRequired("admin", "super"))。
- token 解析推荐用
github.com/golang-jwt/jwt/v5，从中取role或permissions字段 - 细粒度权限（如“能删但不能改”）需在 handler 内部二次判断，中间件只做粗筛
- 不要在中间件里直接操作数据库——中间件职责是拦截或放行，不是业务逻辑
嵌套分组与变量作用域共享的隐含风险
分组之间路由隔离，但变量作用域不隔离。所有分组共用同一个 *gin.Engine 实例，所以你在某个分组里定义的局部变量（比如 var v1 = r.Group(...)），不影响其他分组；但如果你在中间件里用了闭包捕获外部变量，又没注意并发安全，就可能出问题。
比如下面这种写法有隐患：
for _, role := range []string{"admin", "user"} {
group := r.Group("/" + role).Use(RoleRequired(role))
}
因为 role 是循环变量，所有闭包最终都捕获到同一个值（最后一个）。正确写法是传参或引入新作用域。
- 分组注册后即使变量丢失（如
v1被 GC），路由依然有效——路由树已构建完成 - 中间件复用时，避免在闭包中直接引用可变外部状态
- 调试时别只看路径是否匹配，重点查
c.Get()是否拿到预期值、c.Abort()是否真被调用
