gin中路由冲突源于radix tree匹配机制，/user/new被/user/:id拦截是因为后者先注册抢占前缀分支；需通过[gin-debug]日志顺序和router.routes()统计验证，静态路径必须在动态段前注册，group不改变树结构优先级。
Gin 中路由“重名”不是传统意义上的字符串重复，而是 Radix Tree 路由树在匹配时因路径结构冲突导致的逻辑覆盖——/user/new 被 /user/:id 拦截，就是典型表现。它不会报错，但请求永远进不了你预期的 handler。
怎么看是不是真有路由冲突
启动服务时紧盯控制台输出的 [GIN-debug] 日志，重点看 GET（或对应方法）后跟的完整路径行：
- 如果
/user/:id出现在/user/new之前，那/user/new就已被树结构“忽略”——Radix Tree 不按注册顺序覆盖，而是按节点静态性优先匹配 - 运行
router.Routes()获取所有注册路由切片，用map[string]int统计Method + Path组合出现次数，值 >1 的就是硬冲突源（比如同一路径注册了两次 GET） - 别信 Group 隔离能防冲突：哪怕你写
v1 := r.Group("/v1"); v1.GET("/users/new", ...); v1.GET("/users/:id", ...)，只要/users/new没在/users/:id前注册，照样被吞
为什么 /user/new 总是进 /user/:id
因为 Gin 底层用的是 httprouter 的 Radix Tree 实现，动态段 :id 是通配节点，而静态路径 /user/new 是叶子节点；树构建时若 /user/:id 先注册，它就会抢占整个 /user/ 前缀下的非精确匹配分支，后续注册的 /user/new 因无法插入已有通配分支下而失效。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 必须把明确的、无参数的路径提前注册：
/user/new、/user/profile、/user/stat全部写在/user/:id之前 - 检查是否误拼前缀：比如
r.Group("/user").GET("/user/new", ...)实际注册成了/user/user/new，和/user/:id不在同一层级，自然不冲突——但你也根本访问不到/user/new -
/user/new/（带尾斜杠）会被自动 301 重定向到/user/new，前提是gin.RedirectTrailingSlash为 true（默认开启），但这不影响冲突判断
catch-all 通配符引发 panic 怎么办
错误信息里出现 wildcard route conflicts with existing children 或 index out of range，基本锁定是 *filepath 类通配符和同级静态路径打架了。
- 绝对不要同时注册
/static/和/static/*filepath——前者是空尾路径，后者是通配，Radix Tree 不允许同级共存 - 手动注册 catch-all 时，路径末尾必须带斜杠：
/static/*filepath✅，/static/*file❌（缺斜杠会触发索引越界 panic） - 静态文件服务直接用
r.StaticFS("/static", http.Dir("./static"))，它内部已规避冲突，不用手写通配
最常被忽略的一点：路由注册顺序不是代码书写顺序，而是实际调用 .GET() 等方法的执行顺序——比如函数内注册、init() 里注册、甚至跨文件 init 执行顺序都可能打乱你以为的“先后”。调试时别只看代码排版，要盯日志输出顺序。
