*filepath 必须位于路径末尾且前有斜杠，否则触发 panic；注册顺序决定匹配优先级，静态路由需前置，通配路由应后置，避免与同级静态路径冲突。
为什么 *filepath 会导致 panic: wildcard route conflicts with existing children
这个 panic 不是 Gin “不讲武德”，而是 Radix Tree 在构建时发现你试图在已存在通配符节点的路径下，再注册一个同级静态子路径。比如你先注册了 /static/*filepath，之后又在同一个前缀下（例如通过 r.Group("/static")）调用 .GET("/css/app.css", ...) —— Gin 会认为 /static/css/app.css 是 /static/*filepath 的“孩子”，但通配符节点本身已声明“我覆盖所有剩余路径”，不能再有显式子节点。
常见触发场景：
- 手动注册
/static/（带尾斜杠）后，又注册/static/*filepath - 在
r.Group("/api/:version")内，又注册GET "/api/v1/users"这种字面量路径 - 多个
StaticFS或Static调用路径前缀重叠，比如/assets和/assets/js
/static/*filepath 必须带尾部斜杠，否则 runtime panic
这是 Gin 的硬性约束：*filepath 通配符必须出现在路径末尾且其前面必须是斜杠，即 /static/*filepath 合法，/static/*file 或 /static*filepath 都会触发 index out of range panic。原因在于 Gin 解析通配符时依赖斜杠做段切分，缺斜杠会导致索引越界。
正确写法示例：
r.GET("/files/*filepath", func(c *gin.Context) {
path := c.Param("filepath") // 返回 /logo.png，含开头斜杠
c.File("./files" + path)
})
错误写法（直接 crash）：
r.GET("/files/*file", ...) // panic
r.GET("/files*filepath", ...) // panic
r.GET("/files/*filepath/", ...) // 多余斜杠，匹配不到 /files/logo.png
静态资源与通配路由共存时，注册顺序决定生死
Gin 匹配不是“最长前缀优先”，而是“注册顺序决定 fallback 优先级”：静态路径越早注册，越容易被命中；通配路由越晚注册，越不容易误吞。
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
必须遵守的注册顺序：
-
r.Static("/static", "./static")→ 必须放在所有GET、Group、NoRoute之前 -
r.StaticFS("/assets", http.Dir("./assets"))→ 同样需前置，且不能和/assets/*filepath共存 -
r.NoRoute(...)→ 应该是最后注册的兜底逻辑，但若你用了/*path这类通配，它必须比任何可能被它覆盖的 API 路由更晚注册
典型翻车链：
r.GET("/api/users", handler) // ✅ 正常注册
r.NoRoute(func(c *gin.Context) { // ❌ 错！NoRoute 里若返回 index.html，会劫持 /api/users
c.File("dist/index.html")
})
// 正确顺序应是：
r.Static("/static", "./static") // 第一
r.Static("/assets", "./assets") // 第二
r.GET("/api/users", handler) // 第三
r.NoRoute(...) // 最后
想让 /user/new 不被 /user/:id 吞掉？别信 Group，只看注册行号
router.Group() 只是拼接前缀的语法糖，不改变 Radix Tree 构建顺序。哪怕你写成：
v1 := r.Group("/v1")
v1.GET("/users/new", handlerA) // 注册路径是 /v1/users/new
v1.GET("/users/:id", handlerB) // 注册路径是 /v1/users/:id
只要 /v1/users/new 这一行代码出现在 /v1/users/:id 之前，树中就会为 new 单独建叶子节点；反之，:id 就会作为通配节点覆盖整个 /v1/users/ 前缀空间。
验证方法只有两个：
- 启动时紧盯
[GIN-debug]日志，看/v1/users/new是否出现在/v1/users/:id上方 - 运行
r.Routes()打印全部路由，按Method+Path排序，确认无重复或错位
最保险的做法：把所有明确的、无参数的路径（如 /health、/docs、/admin/login）统一提到文件顶部注册，泛化路由（:id、*filepath）一律压到文件底部。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
