静态路由必须先注册、动态路由（如/user/:id）必须后注册，否则/user/:id会吞掉/user/new；这是Radix Tree构建机制决定的：/user/:id作为通配节点先注册会占据整个/user/前缀空间，导致/user/new无法生成独立叶子节点而被拦截。
静态路由必须先注册，动态路由（如 /user/:id）必须后注册，否则请求会错误落入参数 handler —— 这不是配置遗漏，而是 Gin 的 Radix Tree 构建机制决定的。
为什么 /user/:id 会吞掉 /user/new
Gin 不按“最后注册覆盖”来匹配，而是依赖前缀树节点是否显式存在。/user/:id 是一个通配节点，一旦它先注册，就会在树中占据整个 /user/ 前缀空间；/user/new 若未提前注册为独立叶子节点，就不会被创建，后续请求自然被 :id 拦截，c.Param("id") 返回 "new" 就是典型表现。
常见错误现象：
- 启动时
[GIN-debug]日志里/user/:id出现在/user/new前面 - 访问
/user/new返回 200 但 handler 里拿到的是c.Param("id") == "new" - 用
r.Routes()打印全部路由，发现/user/new根本没出现在列表里
如何安全注册同前缀下的静态与动态路由
关键不是分组、不是中间件，而是字面路径的注册顺序和结构显式性：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“go语言免费学习笔记（深入）”；
- 所有明确无参路径（如
/user/new、/user/profile、/user/stat）必须写在/user/:id之前 -
/user/:id必须是该层级下最后注册的一条路由 - 避免在 Group 内重复拼接前缀：比如
v1 := r.Group("/v1")后，应写v1.GET("/users/new", ...)，而不是v1.GET("/v1/users/new", ...)，后者会导致实际注册为/v1/v1/users/new - 不要指望
router.Group("/api/:version")能兼容/api/v1/users—— 通配分组下再注册静态子路径会直接 panic
通配符（*filepath）引发 panic 的规避方式
这类 panic（如 wildcard route conflicts with existing children）通常发生在同一层级混用静态路径与 catch-all 路由：
- 绝对不要同时注册
/static/和/static/*filepath—— 前者是空尾路径，会与后者冲突 - 要用
*filepath，必须确保路径末尾带斜杠：/static/*filepath✅，/static/*file❌（缺少末尾/可能触发index out of range） - 更推荐直接用
r.StaticFS("/static", http.Dir("./static"))，它内部已处理好安全路径构造，无需手动注册通配符 - 如果必须手写 catch-all，把它放在整个路由树的末尾，且不与任何同级静态路径共存（例如
/files/upload和/files/*filepath不能同级）
最易被忽略的一点：Gin 的路由树在 http.ListenAndServe 启动后就冻结了，运行时增删路由会直接 panic；所谓“热更新”只能靠进程重启或 fork，别信加 mutex 就能安全注册的方案。
