gin 不支持运行时按路由动态加载中间件，use() 必须在路由注册前调用；所谓“动态”实为通过 router.group() 预定义分组+中间件的静态结构，条件跳过应使用 c.abort() 而非尝试动态注册。
直接说结论：Gin 不支持“按路由动态加载中间件”这种运行时条件判断式注册，Use() 必须在路由注册前或注册时明确绑定，所谓“动态”实际是靠路由分组 + 中间件组合实现的静态结构设计。
为什么不能在 c.Next() 里调用 Use()
Gin 的中间件链在路由匹配完成、进入 handler 前就已固定。一旦请求开始执行，Use() 方法已不可再调用——它只作用于 *gin.Engine 或 *gin.RouterGroup 实例的初始化阶段。试图在 handler 或中间件内部调用 Use() 会 panic，错误信息类似：panic: Use() can only be called before adding routes。
-
Use()是构建阶段行为，不是运行时行为 - 所有中间件必须在
r.GET()、rg.POST()等注册路由前确定好顺序和归属 - 所谓“动态”，本质是提前把不同路径的中间件组合写死在分组里
router.Group() 是唯一可靠的路由级中间件隔离方式
想让 /api/v1/user 走鉴权，而 /api/v1/public 不走，不能靠 if 判断路径再加中间件，得用分组显式声明：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
api := r.Group("/api")
v1 := api.Group("/v1")
v1.Use(AuthMiddleware()) // 所有 /api/v1/ 下路由都带这个
v1.GET("/user", GetUserHandler)
<p>pub := v1.Group("/public")
// 不调用 Use()，所以 /api/v1/public/* 不经过 AuthMiddleware
pub.GET("/health", HealthHandler)
</p>
- 分组嵌套无性能损耗，Gin 内部仍是扁平路由树
- 每个
Group()返回新*gin.RouterGroup，自带独立Handlers切片 - 避免在 handler 里写
if path == "/xxx" { ... }—— 这破坏中间件职责，也绕不开 Gin 的执行模型
需要“条件跳过中间件”时，用 c.Abort() 替代“不注册”
比如登录接口 /login 本身不该被鉴权中间件拦截，但又和其他 API 共享同一分组。这时不要试图“动态卸载”，而是在中间件里主动跳过：
func AuthMiddleware() gin.HandlerFunc {
return func(c *gin.Context) {
// 白名单路径直接放行
if c.Request.URL.Path == "/login" || c.Request.URL.Path == "/register" {
c.Next() // 不 Abort，继续往后走（即跳过鉴权逻辑）
return
}
// 正常鉴权流程
token := c.GetHeader("Authorization")
if token == "" {
c.AbortWithStatusJSON(401, gin.H{"error": "missing token"})
return
}
c.Next()
}
}
-
c.Abort()终止后续中间件和 handler 执行；c.Next()继续链式调用 - 白名单判断必须放在中间件开头，否则鉴权逻辑可能已触发副作用（如解析 token 失败 panic）
- 路径匹配建议用
c.Request.URL.Path，而非c.FullPath()（后者含通配符，不稳定）
多个中间件组合时，顺序错一位就全乱
Gin 中间件执行是典型的洋葱模型：外层中间件的 Before → 内层中间件的 Before → handler → 内层 After → 外层 After。注册顺序决定包裹关系：
r := gin.New()
r.Use(A(), B()) // A 包裹 B，B 包裹 handler
r.GET("/test", Handler)
// 请求进来时执行顺序：
// A.Before → B.Before → Handler → B.After → A.After
- 日志中间件通常放最外层（能看到完整耗时），恢复中间件
Recovery()必须在外层兜底 - 鉴权中间件应比业务 handler 更靠近内层，否则
c.Abort()可能来不及拦截 - 修改中间件顺序后务必验证
c.Writer.Status()和响应体是否符合预期——很多 401/403 错误其实是顺序颠倒导致的
真正麻烦的不是写中间件，而是理清哪一层该做什么、在哪一层做。Gin 把中间件链固化在路由树构建期，这个设计决定了“动态加载”只能是伪命题——你写的每一个 Use()，都是在画一张静态的执行拓扑图。
