Gin中/user/:id吃掉/user/new的根本原因是Radix Tree结构特性：/user/:id作为动态段节点代表/user/下所有未显式注册的子路径，必须先注册/user/new等静态路由以构建独立叶子节点，否则会被:id拦截；Group不能改变该优先级。
为什么 /user/:id 会吃掉 /user/new
不是注册顺序写错了，而是 Radix Tree 的节点构建逻辑决定的：/user/:id 是一个动态段节点，它在树中代表「/user/ 下所有未被显式注册的子路径」。只要 /user/new 没在树里作为独立叶子节点存在，请求就会落到 :id 上，c.Param("id") 就变成 "new"。
常见错误现象：
- 访问
/user/new返回 200 但 handler 拿到的是id="new" -
[GIN-debug]日志里/user/:id出现在/user/new前面 - 用
r.Routes()打印路由列表，发现/user/new根本没注册成功
真正起作用的是路径的「静态性」和「注册时序」：Gin 不做最长匹配，也不覆盖旧路由，它只按你写的顺序往树里插节点。静态路径必须先注册，才能让树为它生成确定分支。
修复路由注册顺序的实操要点
把明确、无参数的路径提前注册，泛化路径放后面——这是唯一可靠方式，Group 不能帮你绕过。
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之前 - 如果用了
v1 := r.Group("/v1")，也要确保v1.GET("/users/new", ...)在v1.GET("/users/:id", ...)前面 - 检查是否误拼前缀，比如
v1.GET("/v1/users/new", ...)导致实际注册成/v1/v1/users/new - 验证方式：启动后 curl -I http://localhost:8080/user/new，看响应状态码和 handler 是否如预期
通配符 /*filepath 引发 panic 怎么办
错误日志出现 wildcard route conflicts with existing children 或 index out of range，基本就是 /static/ 和 /static/*filepath 同时存在，或后者少了个尾部斜杠。
- 绝对不要手动注册
/static/（带尾斜杠）和/static/*filepath共存 - 改用
r.StaticFS("/static", http.Dir("./static"))，它内部已处理好安全路径 - 若必须手写 catch-all，路径必须是
/static/*filepath（末尾有/），不能是/static/*file - 删掉所有
/static/这种空尾路径，换成/static（无尾斜杠） +/static/*filepath组合
如何确认路由是否真冲突了
别猜，直接看 Gin 启动时的 [GIN-debug] 日志，那是最真实的路由树快照。
- 逐行比对
GET、POST等方法后跟的路径字符串，看有没有同前缀下静态与动态混排 - 运行
r.Routes()获取全部路由切片，用map[string]int按Method + Path统计，值 > 1 就是硬冲突 - 注意：Gin 的路由树不支持并发注册，
fatal error: concurrent map writes也可能是多 goroutine 同时调用GET导致的假性“冲突”
树结构本身不暴露节点细节，所以日志和 Routes() 是唯二可信来源；别依赖 Group 隔离或中间件顺序来“掩盖”路径注册问题。
