Gin路由冲突源于Radix树构建规则：静态路径（如/user/new）必须先于动态段（如/user/:id）注册，否则后者会覆盖前者导致404；日志中未出现的路由即未进入树，router.Routes()可检测Method+Path硬冲突。
Gin 路由冲突不是“偶尔失效”，而是 Radix 树构建时就已确定——注册顺序错、路径写法混、通配符乱用，三者任一都会让某条路由彻底消失或直接 panic。
为什么 /user/new 总是 404，但 /user/:id 却能访问
根本原因是静态路径注册晚于动态段。Gin 的 Radix 树不支持“覆盖后回退”，/user/:id 先注册，就会吃掉所有 /user/xxx 请求，包括 /user/new。
- 必须把
r.GET("/user/new", ...)放在r.GET("/user/:id", ...)之前 - 启动日志里只看到
GET /user/:id，没打印GET /user/new→ 说明它根本没进树 - Group 内也得守这个规则：哪怕
v1 := r.Group("/v1")，组内v1.GET("/users", ...)仍要早于v1.GET("/users/:id", ...)
router.Routes() 返回的 route.Path 重复，意味着硬冲突
router.Routes() 是运行时真实注册快照，比日志更可靠。只要 Method + Path 组合出现两次，就是明确冲突源。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 检查代码里是否写了两遍
r.GET("/api/v1/users", ...) - 注意大小写和末尾斜杠：
/users和/users/是两个不同 Path - 通配符路径是字面量：
/static/*filepath和/static/同时存在 → 直接 panic，不是 404 - 简单检测逻辑：
pathMap[route.Method+" "+route.Path]++，值 > 1 就得删或改
为什么加了 /*filepath 就 panic: wildcard route conflicts
Radix 树禁止同级节点同时存在空尾路径（如 /static/）和通配符（/static/*filepath），这是内部索引逻辑硬约束，不是配置风格问题。
- 错误组合：
r.GET("/static/", h)+r.GET("/static/*filepath", h) - 错误写法：
r.GET("/static/*file", h)（缺path后缀）或r.GET("/static", h)（无斜杠） - 唯一安全写法：
r.GET("/static/*filepath", h)，且确保没有其他/static或/static/路由 - 更省心方案：
r.StaticFS("/static", http.Dir("./static"))，它已隔离通配逻辑
嵌套路由（如 /users/login）导致静态资源 404 的真正原因
不是 Gin 模板解析出错，是浏览器基于当前 URL 解析 /static/ 时被中间件、重定向或前端路由干扰，误补了前缀。
- 现象：访问
/users/login时，请求变成GET /users/static/css/auth.css - 最常见诱因：HTML 缺
<base href="/">，且服务端有隐式重定向（如 301 到带斜杠路径） - 快速验证：把
/users/login改成/login，如果资源加载正常 → 就是路径歧义问题 - 根治方式：模板顶部加
<base>标签 +r.Static("/static", "./static")显式挂载
真正难排查的从来不是报错，而是某条路由“安静地不存在”——它既不 panic，也不 404，只是永远匹配不到。盯紧 [GIN-debug] 日志顺序，再用 router.Routes() 做最终校验，这两步跳过任何一步，都可能在线上埋下静默故障。
