中间件未调用c.Next()会导致后续路由handler永不执行，请求静默卡住且无错误提示；必须确保每个非终止分支都调用c.Next()，仅鉴权失败等明确需中断时才用c.Abort()。
中间件里没调 c.Next() 导致路由永远不执行
这是最隐蔽也最常被忽略的问题：中间件函数体里写了逻辑，但结尾漏掉 c.Next()，请求就卡在中间件里不动了，后续所有路由 handler 都不会触发。Gin 不会报错、不打日志、也不返回 404，客户端只收到空响应或超时。
常见场景包括鉴权失败后直接 c.AbortWithStatusJSON(401, ...)，却忘了加 c.Next()——这本身没错；但若是在非错误路径（比如日志、埋点）里写了业务逻辑却没调 c.Next()，整个链就断了。
- 必须确保每个中间件分支最终都调用
c.Next()，除非你明确要终止流程（如鉴权拒绝、参数校验失败） - 用
if err != nil { c.AbortWithStatusJSON(...) ; return }是安全的，return后不会再往下走 - 但
if isDebug { log.Println(...) }这种无副作用分支后，必须补上c.Next()
中间件注册顺序错乱，把兜底逻辑放太前
比如把日志中间件、CORS 中间件或自定义 404 拦截中间件放在 r.NoRoute() 或 r.GET() 之前，会导致它提前生效，覆盖本该由路由系统处理的请求。
典型错误是写成：
r.Use(custom404Middleware)
r.GET("/users", handler)
r.NoRoute(func(c *gin.Context) { ... })
此时 custom404Middleware 会在所有请求入口就被执行，哪怕路径是 /users，也会先进入这个中间件——而它如果没调 c.Next()，/users 就永远不会执行。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
r.Use()注册的是全局中间件，对所有路由生效，包括NoRoute触发的兜底请求 - 想只对 API 路径生效？用
group := r.Group("/api")+group.Use(...) - 想实现类似 NoRoute 的“未匹配路径拦截”，别手写中间件去遍历
c.Request.URL.Path，直接用r.NoRoute()更可靠
中间件中修改了 c.Request.URL.Path 却没同步更新路由匹配上下文
Gin 的路由匹配发生在中间件执行前，靠的是原始 c.Request.URL.Path 值构建的 Radix Tree 查找。如果你在中间件里改了它（比如做路径重写、移除前缀），但没通知路由系统重新匹配，请求仍会按原始路径去查树，大概率 404。
例如，在中间件里写 c.Request.URL.Path = strings.TrimPrefix(c.Request.URL.Path, "/v1")，然后期望 r.GET("/users") 能命中 /v1/users —— 这不会生效，因为路由树里注册的是 /v1/users，不是 /users。
- 路径重写必须在路由注册前完成，比如用
r.Group("/v1").GET("/users", ...) - 若必须运行时改路径，得配合
c.Request.URL.RawPath和c.Request.URL.Opaque一起维护，且极难保证兼容性 - 更稳妥的做法：让前端或网关层做前缀剥离，Gin 只处理干净路径
并发写路由树导致 panic：中间件里动态注册路由
有些同学会在中间件里根据请求参数动态调用 r.POST(...) 或 group.GET(...)，比如“用户登录后才加载其专属 API”。这是危险操作：Gin 的路由树不是线程安全的，任何运行时注册都会触发 fatal error: concurrent map writes。
这个 panic 不一定立刻出现，可能压测时才爆发，而且堆栈指向 runtime，很难定位到是中间件干的。
- 所有
r.GET、r.POST、r.Group必须在r.Run()之前完成，不能放到中间件、handler 或 goroutine 里 - 需要动态行为？用策略模式：预注册所有可能路由，中间件里只做权限/开关判断，
c.Abort()或c.Next() - 真要热加载？换用支持运行时注册的框架（如 Echo），或自己维护路由映射表+反射调用
