gin路由是否生效取决于radix树中是否存在对应叶子节点；需确保静态路径（如/user/new）在动态段（如/user/:id）之前注册，否则后者会覆盖前者，导致静态路由失效。
启动时盯紧 [GIN-debug] 日志行
Gin 启动后控制台输出的 [GIN-debug] 日志是第一手证据，不是辅助手段——它直接反映 Radix 树实际构建结果。每条日志形如 GET /user/:id 或 GET /user/new，其打印顺序就是路由在树中被识别的优先级顺序。
常见错误现象：你写了 r.GET("/user/:id", ...) 在前、r.GET("/user/new", ...) 在后，但日志里 GET /user/:id 先出现，GET /user/new 根本没打印出来。这说明后者已被前者覆盖，树中未生成独立节点。
- 只要两条路由共享相同前缀（如
/user/），且一个是动态段（:id）、一个是纯静态路径（new），就必须确保静态路径先注册，否则不会出现在日志里 - 若日志中同一 Method + 相似 Path 出现多次（比如
GET /api/v1/users和GET /api/v1/users/:id都存在），但后者排在前面，那前者大概率失效 -
[GIN-debug] Listening and serving HTTP之前的所有GET/POST行，就是当前生效的全部路由快照
用 router.Routes() 检查硬冲突
router.Routes() 返回的是 []gin.RouteInfo 切片，它是运行时真实注册状态的镜像，比日志更权威——日志可能因 panic 被截断，而这个切片总能拿到。
关键不是看数量，而是按 Method + Path 做键去重统计。值大于 1 的，就是明确的硬冲突源。
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
- 写个简单循环遍历：
pathMap := make(map[string]int)，对每个route执行pathMap[route.Method+" "+route.Path]++ - 冲突典型场景：
GET /static/和GET /static/*filepath同时存在 → panic；GET /api/:version/users和GET /api/v1/users同级注册 → 后者不生效 - 注意
Path字段不含通配符展开，/static/*filepath就是字面量，不是/static/xxx；所以不能靠字符串前缀判断，必须严格匹配整个Path
避免 /*filepath 引发 index out of range panic
显式注册 catch-all 路由时，*filepath 末尾是否带斜杠，直接决定会不会 panic。这不是风格问题，是 Gin Radix 树内部索引逻辑的硬约束。
错误写法：r.GET("/static/*file", handler) 或 r.GET("/static/", handler) —— 前者缺斜杠，后者是空尾静态路径，两者叠加会触发 index out of range。
- 正确做法只有一种：
r.GET("/static/*filepath", handler)，且确保没有其他/static/或/static路径存在 - 更安全的替代方案：直接用
r.StaticFS("/static", http.Dir("./static"))，它内部已处理好路径拼接和节点隔离，不会产生冲突 - 如果必须手动注册通配路由，务必确认该路径下没有任何同级静态子路径（包括
/static/favicon.ico这种文件级路径）
Group 内注册顺序仍需「具体在前、泛化在后」
router.Group() 不是路由隔离墙，它只是路径前缀拼接器。你在 v1 := r.Group("/api/v1") 里注册的 v1.GET("/users/:id", ...)，和直接写 r.GET("/api/v1/users/:id", ...)，在 Radix 树中的位置完全一致。
这意味着 Group 完全不改变匹配优先级逻辑——组内路由依然要遵守「静态路径先于动态段」原则。
- 错误示范：
v1 := r.Group("/api/v1"); v1.GET("/users/:id", h1); v1.GET("/users/profile", h2)→/users/profile永远进不去 - 正确写法：
v1.GET("/users/profile", h2); v1.GET("/users/:id", h1)，顺序不能颠倒 - 想强制某条路由最优先？唯一可靠方式是把它放在整个
r := gin.Default()初始化后的最早位置，而不是依赖 Group 嵌套层级
/user/new 没能在树中生成独立分支，后续任何调试、中间件或日志注入都救不回来——它根本不会进入匹配流程。
