直接调用 e.Group() 创建分组,返回新 echo.Group 实例,路径前缀自动生效;分组内路由路径勿加前导斜杠,中间件需显式挂载,版本号必须体现在路径中。

如何用 e.Group() 创建路由分组
直接调用 e.Group() 即可创建分组,它返回一个新的 echo.Group 实例,后续所有路由都挂载在该分组路径前缀下。不要手动拼接路径字符串,也不要嵌套调用 Group() 多次——这会导致路径冗余和中间件漏挂。
常见错误:写成 e.Group("/api").Group("/v1").Group("/users"),结果注册 GET("") 时实际匹配的是 GET /api/v1/users,但调试时容易忽略某层前缀是否生效;更糟的是中间件只挂在最外层,内层路由却没被保护。
-
/api/v1/users是合理路径,对应e.Group("/api/v1/users") -
/api/v1+/users是冗余拆分,应避免 - 分组变量名建议体现业务域,比如
userGroup := e.Group("/api/v1/users"),而不是v1Group或apiGroup
分组中间件必须显式挂载到该分组
中间件不会自动继承。你在根 e 上调用 Use(),只影响根级路由;分组内的路由必须自己调用 Use() 才会生效。这是最容易被忽略的点——看着代码里有 JWT(),但某个分组忘了挂,结果接口就裸奔了。
示例中如果只在 e.Use(middleware.JWT()),而 userGroup 没再调一次 Use(),那么 userGroup.GET("/me", handler) 就不校验 token。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 每个分组只挂自己需要的中间件:用户相关接口挂
auth和rateLimit,公开文档接口只挂cors - 日志中间件建议放在根
e,除非你明确要按分组隔离日志上下文 - 别把所有中间件塞进一个
e.Use(...)然后指望子分组全继承
版本号必须体现在路径中,不能靠 query 或 header
用 e.Group("/api/v1") 而不是 e.Group("/api") 再靠 Accept: application/vnd.myapp.v1+json 区分版本。CDN、反向代理、浏览器缓存、客户端 SDK 都无法可靠识别 header 或 query 版本,路径是唯一能被所有环节一致解析的方式。
错误做法:e.GET("/users?version=v2", handler) 或 e.GET("/users", handler).Name("v2-users") —— 这些对路由匹配、缓存控制、网关策略完全无效。
- 路径版本必须可读、稳定、不可省略,如
/api/v1/posts、/api/v2/posts - 不同版本分组应独立声明:
v1 := e.Group("/api/v1")、v2 := e.Group("/api/v2") - 不要复用 handler 函数名来暗示版本,比如
listUsersV2—— 路径本身才是版本契约
分组内部定义路由时,路径以 / 开头或不加前缀?
分组内注册路由时,路径**不要加前导 /**。因为 e.Group("/api/v1/users") 已经定义了前缀,再写 userGroup.GET("/profile", handler) 实际匹配的是 GET /api/v1/users/profile;但如果误写成 userGroup.GET("profile", handler)(无斜杠),结果一样——Echo 会自动补前导斜杠。
真正要注意的是语义清晰性:统一用无前导斜杠风格,比如 userGroup.GET("profile", handler)、userGroup.POST("search", handler),避免混用造成阅读困惑。
-
userGroup.GET("profile", handler)✅ 推荐,简洁且与分组路径逻辑一致 -
userGroup.GET("/profile", handler)⚠️ 可运行但易误导,看起来像绝对路径 - 空字符串
""表示匹配分组路径本身,如userGroup.GET("", listAll)→GET /api/v1/users
Group() 调用上。写错一次,后面加十个注释也盖不住问题。


















