echo路由必须在e.start()前静态注册，handler内调用e.group或get无效且静默忽略；动态逻辑应通过兜底路由+中间件分流实现，而非运行时修改路由树。
不能在 handler 里调用 e.Group 或 GET 动态注册路由
所有 Echo 路由必须在 echo.New() 后、e.Start() 前完成注册。一旦服务启动，e.Group("/api/v2") 或 v2.GET("/users", handler) 在 handler 内执行不会生效，也不会报错——只是 silently 被忽略。后续请求仍走原路由树，必然 404。
常见错误现象：
- 数据库新增一条规则后，手动在某个管理接口里调用
e.Group("/dynamic").GET("/:id", dynamicHandler)，但访问/dynamic/123仍返回 404 - 并发请求触发多次注册，引发 panic：
panic: echo: group already exists
真正可落地的“动态”，只发生在启动阶段：读配置 → 构建分组 → 注册路由。例如从 etcd 加载路径规则列表，循环调用 e.Group(rule.Prefix).Add(rule.Method, rule.Path, handler)。
用 e.Group + 中间件实现运行时逻辑分流，不是改路由表
所谓“动态分发”，90% 场景其实是根据请求上下文（如 token scope、Header 特征、用户角色）决定走哪条业务分支，而不是实时增删路由节点。这该由中间件完成，不是路由注册逻辑。
推荐做法：
- 统一注册一个兜底路由，如
e.Any("/v1/:service/*path", dispatchHandler)，其中:service是服务名，*path捕获剩余路径 - 在
dispatchHandler中解析c.Param("service")，查数据库或内存缓存拿到对应 handler 函数或微服务地址 - 用
c.Set("target_handler", h)或直接h(c)调用，避免反射或字符串匹配 - 权限校验、灰度标识、版本路由都放在这里做，不污染路由定义层
注意：*path 会吞掉所有斜杠，:service 只能是单段；别写成 /v1/:service/:id/*path——:id 永远捕获不到。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
c.Param 是唯一安全取路径参数的方式，别手动 strings.Split
路径参数（如 /api/v1/users/:id）经 Echo 解析后，已做 URL 解码、路径规范化（合并 //、去除末尾 /），c.Param("id") 返回的就是最终可用值。手动用 c.Request.URL.Path 拆分极易出错。
典型问题：
-
/user/123%2Fedit中的%2F是编码后的/，strings.Split会误拆成["", "user", "123%2Fedit"]，而c.Param("id")自动解码为"123/edit" - 路径含双斜杠
/api//v1会被标准化为/api/v1，手动解析可能漏掉中间空段导致越界 - 未匹配参数时
c.Param("xxx")返回空字符串，不会 panic；而自己切片可能 panic
多版本并存必须固化版本前缀，别依赖 Header 或 Query
/api/v1/users 和 /api/v2/users 必须是不同路径。用 Accept: application/vnd.myapi.v2+json 或 ?version=v2 实现版本控制，CDN、网关、浏览器缓存都会失效——同一 URL 可能被缓存为 v1 响应，却转发给 v2 服务。
正确结构：
- 扁平化声明：
usersV1 := e.Group("/api/v1/users")，usersV2 := e.Group("/api/v2/users") - 各自挂专属中间件：
usersV1.Use(middleware.JWT())，usersV2.Use(auth.OAuth2WithScope("users:read")) - handler 独立实现：
usersV1.GET("/:id", v1GetUser)，usersV2.GET("/:id", v2GetUser)
嵌套分组（如 e.Group("/api").Group("/v1").Group("/users")）会导致中间件作用域混乱、调试路径与实际匹配路径不一致，运维排查成本陡增。
真正的动态性不在路由注册时机，而在 handler 内部对请求元数据的响应能力。路径结构要稳，逻辑分支要活——把“变”的部分收口到中间件和 handler，而不是试图让路由树在运行时长出新枝。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
