Gin 不支持运行时增删路由，因其路由树在启动前已静态编译，运行时调用 GET/POST/Group 会 panic；c.Param("id") 是获取路径参数的唯一可靠方式，需手动类型转换与校验。
为什么不能在运行时增删 Gin 路由
Gin 的路由树在 r.Run() 之前就完成静态编译，运行时调用 GET、POST 或 Group 会直接 panic——不是设计缺陷，而是明确禁止的行为。常见错误现象包括：wildcard route conflicts with existing children、测试时路由状态无法重置、热更新后新路由不生效。
根本原因在于：gin.Engine 内部使用 httprouter 的 trie 结构，没有并发安全的修改接口；中间件链、路由匹配逻辑都依赖启动时确定的树结构。所谓“动态”，90% 场景其实是在启动阶段做条件注册，而非运行时修补。
可行做法是：
- 用环境变量（如
os.Getenv("ENABLE_ADMIN")）控制是否执行某段r.Group()注册逻辑 - 把中间件注入逻辑提前到
Group创建时，而不是试图后期追加 - 避免在 handler 里写
if adminEnabled { r.GET(...) }—— 这种写法永远不生效
c.Param() 获取路径参数的正确姿势
c.Param("id") 是唯一可靠方式，它不自动类型转换、不校验存在性，只返回字符串。很多人误以为它像 ShouldBind() 那样能报错或默认值，结果在 strconv.Atoi(c.Param("id")) 时 panic。
必须注意：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 参数名严格大小写敏感，
/user/:ID和c.Param("id")不匹配 - 路由未匹配成功时，
c.Param()返回空字符串，不是nil或 panic - 不要自己用
strings.Split(c.Request.URL.Path, "/")解析 —— 路由匹配可能含通配符（如/*action），切分不可靠 - 适合场景：日志记录、缓存 key 拼接、权限检查等无需强类型的轻量操作
c.ShouldBindUri() 绑定路径参数到结构体
当路径参数多、需类型转换或校验时，c.ShouldBindUri() 是 Gin 推荐方案。它只处理 URI 中的 :param，不读取 query 或 body，且依赖 struct tag uri:"name"。
典型坑点：
- 结构体字段必须首字母大写（可导出），否则反射失败
- 字段名与
uritag 值必须完全一致，Year int `uri:"year"`中year小写，字段Year大写，但 tag 名才是绑定依据 -
c.ShouldBind()完全忽略uritag —— 它按 Content-Type 自动选绑定器（JSON/form），不会看 URI - 不支持嵌套结构体，所有字段必须平铺在顶层
示例：
type PostUri struct {
Year int `uri:"year" binding:"required,min=2000"`
Month int `uri:"month" binding:"required,min=1,max=12"`
}
func handler(c *gin.Context) {
var u PostUri
if err := c.ShouldBindUri(&u); err != nil {
c.AbortWithStatusJSON(400, gin.H{"error": err.Error()})
return
}
// u.Year, u.Month 已为 int 类型且通过校验
}
Query、Form、JSON 参数别和路径参数混用
新手常把 c.Query("id") 当成 c.Param("id") 用，或对 JSON 请求体调用 c.ShouldBindUri()，结果全是空值。Gin 明确区分三类来源：
-
c.Param()/c.ShouldBindUri()→ 仅来自 URL 路径（/user/:id） -
c.Query()/c.ShouldBindQuery()→ 仅来自 URL 查询字符串（?id=123） -
c.PostForm()/c.ShouldBind()→ 来自表单或 JSON，取决于 Content-Type
最易被忽略的一点：没有“通用绑定”函数能同时覆盖这三者。需要混合参数时，得手动组合调用，比如路径 ID + 查询分页 + JSON body 数据，就得分别取、分别校验。
