Group自动注入前缀,分组内路由不可重复写前缀,否则路径重复导致404;多级分组需逐层声明,中间件不自动继承,应按业务模块或版本号划分粒度,路径参数需语义明确。

直接用 r.Group(),不是拼字符串,也不是嵌套命名空间;前缀由 Group 自动注入,手动重复写会注册出双倍路径。
为什么 r.Group("/api/v1") 后不能写 GET("/api/v1/users")
Group 已经把前缀加进去了,你在分组内再写完整路径,Gin 会拼成 /api/v1/api/v1/users。这不会报错,但路由根本匹配不到——你发 GET /api/v1/users 请求时,引擎实际在找 /api/v1/api/v1/users。
- ✅ 正确:
v1 := r.Group("/api/v1"); v1.GET("/users", handler)→ 匹配/api/v1/users - ❌ 错误:
v1.GET("/api/v1/users", handler)→ 注册为/api/v1/api/v1/users - ⚠️ 前缀末尾多一个
/也危险:r.Group("/api/v1/")可能导致GET("")解析为/api/v1//xxx,某些 Gin 版本会静默失败或 404
Group 是路由树节点,不是语法糖
它不是为了“看起来整齐”而设的封装,而是 Gin 路由树的真实分支节点。所有分组最终都挂载在同一个 *gin.Engine 实例上,共享同一棵 Radix 树。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 子分组只继承**直接父级**前缀,
r.Group("/a").Group("/b").Group("/c")最终注册的是/c,不是/a/b/c - 要实现多级前缀,必须逐层声明并立即用花括号包裹:
v1 := r.Group("/api/v1"); users := v1.Group("/users") - 中间件不自动继承:父分组挂了
AuthMiddleware(),子分组不会自动带上,必须显式调用users.Use(AuthMiddleware())或在创建时传入
模块分组该按什么粒度切
别按技术层(比如 controller / service),要按业务边界或版本号。路径参数名也要语义明确,避免多个模块共用 :id 导致取值混淆。
立即学习“go语言免费学习笔记(深入)”;
- 推荐以业务模块为单位平铺:
r.Group("/users")、r.Group("/orders")、r.Group("/payments") - 版本控制建议放第一层:
v1 := r.Group("/v1"),再在其下挂模块组,如v1.Group("/users") - 禁止模糊注册:
Any()会破坏 REST 约束,也绕过 Gin 的路径优先级匹配逻辑(静态 > 参数 > 通配符) - 路径参数命名需带上下文:
/users/:user_id、/orders/:order_id,而不是统一用:id
最常被忽略的一点是:Group 不隔离变量作用域,也不改变中间件执行顺序的底层逻辑——r.Use() 注入到整个 handler 链最前端,而 group.Use() 只影响该分组内注册的 handler。如果在分组里漏掉中间件,或者误以为父级中间件会穿透到子分组,线上就容易出现未鉴权访问或日志缺失。


















