路由重名不报错但会导致请求被错误处理，必须通过日志检查路径顺序、调用router.routes()校验重复、警惕group嵌套和通配符冲突。
路由重名不会报错，但会导致请求被错误 handler 处理——必须靠日志和运行时检查主动发现。
启动时盯紧 [GIN-debug] 日志里的路径顺序
Gin 不校验重复注册，只按注册顺序构建 Radix Tree。同一 Method + Path 注册两次，后一次会覆盖前一次，但控制台不会提示；而更危险的是「看似不同、实则冲突」的路径，比如 /user/:id 和 /user/new。
- 启动服务后，立刻扫一遍所有
[GIN-debug] GET（或 POST/PUT 等）行，注意路径字符串是否重复出现 - 重点看动态段
:id是否排在静态路径/user/new前面——如果/user/:id先打印，/user/new就永远进不去 - 别信 Group 的缩进或花括号，
v1 := r.Group("/v1"); v1.GET("/users/new", ...)实际注册的是/v1/users/new，跟/v1/users/:id仍属同级竞争
用 router.Routes() 拿出全量路由做去重校验
仅靠肉眼容易漏，尤其当路由分散在多个文件或 init 函数里时。直接调用 router.Routes() 返回 []gin.RouteInfo 切片，对每条记录用 Method + Path 当 key 统计频次：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 写个简单遍历：把
r.Routes()结果塞进 map，key 是route.Method + ":" + route.Path - 值大于 1 的 key 就是硬重名项，比如两个
GET:/api/order - 注意区分大小写：
/API/order和/api/order在 Gin 中是两条不同路由（默认不开启大小写自动修正）
警惕 Group 嵌套导致的隐式路径拼接重复
Group 只是语法糖，不是命名空间隔离。常见陷阱是手动加了前缀又用 Group 拼一次：
- 错误写法：
r.Group("/api").GET("/api/v1/users", handler)→ 实际注册为/api/api/v1/users，但你可能以为是/api/v1/users - 更隐蔽的：多个文件都注册了
r.Group("/admin").GET("/dashboard", ...)，结果生成两条/admin/dashboard路由，后者覆盖前者 - 验证方法：打印
route.Path值，别只看代码里的字符串字面量
通配符 /*filepath 和静态路径同级会 panic
这不是重名而是结构冲突：/static/*filepath 和 /static/ 同时存在，Gin 构建树时会触发 wildcard route conflicts with existing children panic。
- 现象：服务启动直接 crash，堆栈指向
tree.go的 insert 或 getValue 方法 - 原因：Radix Tree 不允许通配符节点下再挂静态子节点，也不允许同级既有
/static/又有/static/*filepath - 解法：删掉显式的
/static/，改用/static（无尾斜杠）+/static/*filepath；或直接用r.StaticFS("/static", http.Dir("./static"))，它内部已规避该问题
真正难排查的从来不是明面上的重复，而是 :id 吞掉 /new、Group 拼接翻倍、通配符卡死启动——这些都得靠运行时数据说话，不能只看代码写了啥。
