*filepath必须注册在最后，因为Gin路由树按注册顺序fallback且不作最长前缀匹配，若提前注册会拦截后续更具体的静态或参数路由，导致其失效，并禁用前缀剪枝优化引发性能退化。
模糊匹配不是“万能兜底”，而是有明确优先级和性能代价的显式选择；*filepath 路由必须放在最后注册，否则会干扰前面所有静态和参数路由的匹配。
为什么 *filepath 必须注册在最后？
Gin 的路由树按注册顺序 fallback，不作最长前缀匹配。一旦某个节点命中 *filepath，它就会吃掉该节点下所有未被更具体路由覆盖的路径，且后续同级路由完全失效。
- 错误写法：
r.GET("/static/*filepath", handler)放在r.GET("/static/css/app.css", handler)前 → 后者永远不生效 - 正确顺序：先注册所有静态路径和
:id路由，*filepath仅作为兜底放在最后 - 注意：
*filepath会禁用整棵子树的前缀剪枝优化，导致该分支下所有匹配都退化为线性扫描
:id 和 *filepath 的匹配行为差异
:id 匹配单个路径段（如 /user/123 中的 123），*filepath 匹配剩余全部（如 /file/a/b/c.txt 中的 /a/b/c.txt）；二者不能混用在同一路径层级。
-
/api/:version/users/:id✅ 合法，两个参数独立 -
/api/:version/*filepath✅ 合法，通配符必须在末尾 -
/api/*filepath/:id❌ 语法错误，Gin 解析失败并 panic - 获取值方式不同：
c.Param("id")vsc.Param("filepath")，后者带开头斜杠（如/a/b/c）
高频路径下滥用 *filepath 的真实代价
在 / 或 /api 这类根级路径注册 *filepath，会让整个子树失去 Trie 的前缀跳过能力，所有请求都要遍历到叶子节点才能确认是否匹配。
立即学习“go语言免费学习笔记（深入）”；
- 表现：QPS 下降明显，pprof 显示
node.getValue占比飙升 - 替代方案：用
router.NoRoute()捕获 404，再根据c.Request.URL.Path手动分发，可控且无性能污染 - 若真需通配，限定范围：
/uploads/*filepath比/*filepath安全得多
动态路由注册时的并发 panic 风险
GET、POST、Group 等注册函数直接修改底层 Trie 树指针，全程非线程安全。启动后任何 goroutine 尝试增删路由都会触发 fatal error: concurrent map writes。
- 常见误操作：HTTP 接口接收 JSON 配置，然后调用
r.POST(...)动态加路由 - 安全做法：只在
http.ListenAndServe前完成全部路由注册；热更新必须靠进程重启或 exec fork - 别信“加 mutex 就能热更”——Trie 节点间存在多向指针引用，锁住入口函数无法阻止内部 link 竞争
真正难处理的不是语法怎么写，而是当 *filepath 和 :id 共存时，你得清楚哪条路径实际会被哪个 handler 拦截；Gin 不报错，但结果往往和直觉相反。
