Echo框架路由分组如何创建-Golang-PHP中文网

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

echo框架路由分组如何创建

如何用 `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。

每个分组只挂自己需要的中间件：用户相关接口挂 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 版本，路径是唯一能被所有环节一致解析的方式。

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

错误做法：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)，避免混用造成阅读困惑。