能共存，但 Gin 按注册顺序匹配路由，静态路由必须写在动态路由之前，否则如 /admin 会被 /admin/:id 提前捕获；推荐用 r.Group 统一管理并按从具体到泛化排列。
静态路由和动态路由能共存吗？能，但顺序很重要
能共存，但 Gin 会按注册顺序匹配路由，一旦命中就停止查找。所以必须把更具体的静态路由写在动态路由前面，否则 /users 这样的静态路径会被 /users/:id 提前捕获。
常见错误现象：访问 /admin 返回 404，而 /admin/123 却能进 handler —— 很可能是因为 /admin/:id 注册在了 /admin 前面。
- 静态路由如
r.GET("/health", healthHandler)必须放在r.GET("/users/:id", userHandler)之前 - 同一组路由建议统一用
r.Group管理，避免散落在不同位置导致顺序失控 - Gin 不支持“路由优先级”配置，顺序即优先级，靠代码书写顺序决定
如何正确注册混合路由？用 Group + 显式路径控制
推荐用 r.Group 划分语义区域，再在组内按从具体到泛化排列。比如管理后台的路由通常既有固定页面（/admin/dashboard），也有资源操作（/admin/users/:id）。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
// 正确示例：先静态，后动态
admin := r.Group("/admin")
{
admin.GET("/dashboard", dashboardHandler) // 静态
admin.GET("/settings", settingsHandler) // 静态
admin.GET("/users", listUsersHandler) // 静态列表
admin.GET("/users/:id", getUserHandler) // 动态详情
admin.POST("/users", createUserHandler) // 动态创建
}
- 不要在同一个
Group内混用GET("/users")和GET("/users/:id")时省略中间步骤——Gin 能区分，但人容易看错 - 如果静态路径是动态路径的前缀（如
/api/v1和/api/v1/:id），务必确认/api/v1是完整路径，不是/api/v1/（结尾斜杠差异会影响匹配） - 调试时可用
r.Routes()打印所有注册路由，检查顺序和路径是否符合预期
动态路由参数冲突怎么查？看 c.Param() 返回值是否为空
当请求本该命中静态路由却进了动态 handler，大概率是路径被动态规则提前匹配了；反过来，若动态路由取不到参数，可能是静态路由拦截了，或路径拼写有误（比如少了个斜杠）。
典型错误：访问 /posts/123 时 c.Param("id") 返回空字符串 —— 检查是否注册了 /posts/:id，还是只写了 /post/:id（少了个 s）。
- 在 handler 开头加日志：
log.Printf("path=%s, id=%s", c.Request.URL.Path, c.Param("id")) - 注意参数名大小写：Gin 的
:id和:ID是不同的参数键，c.Param("ID")在:id下永远为空 - 多个参数时（如
/users/:uid/posts/:pid），必须按顺序调用c.Param("uid")、c.Param("pid")，不能颠倒
要不要用通配符路由 /*action？除非真需要兜底，否则别碰
/*action 是 Gin 的通配符路由，匹配任意深度路径，但它会吃掉所有未匹配的请求，包括你忘了写的静态路由。它适合做 404 统一处理或代理转发，但不适合和常规路由混用。
- 如果用了
r.GET("/*action", fallbackHandler)，又没在它前面注册/about，那访问/about就会进fallbackHandler而不是你的 about 页面 - 真正需要兜底时，把它放在所有其他路由之后，并确保 handler 显式检查路径合法性，避免把 API 错误也吞掉
- 生产环境建议用
r.NoRoute()替代/*action做 404 处理，更安全、语义更清晰
r.Routes()，比猜半天快得多。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
