路由级中间件需直接传入r.get()等方法且位于handler之前，如r.get("/api/user", authmiddleware, userhandler)；顺序错误、类型不符或漏return会导致失效，其作用域仅限单条路由，与use()全局或group()局部全局不同。
直接在 r.GET()、r.POST() 等路由注册函数中，把中间件作为参数传进去，就能只对那条路由生效——不是加在 Use() 里，也不是塞进路由组。
路由级中间件怎么写：参数位置不能错
中间件必须放在 handler 函数之前，且和 handler 一起作为参数传给 r.GET() 等方法。顺序错了或类型不对，Gin 不会报错，但中间件根本不会执行。
-
r.GET("/api/user", authMiddleware, userHandler)✅ 正确：中间件在前，handler 在后 -
r.GET("/api/user", userHandler, authMiddleware)❌ 错误：Gin 只认最后一个参数是 handler，其余全被忽略 -
r.GET("/api/user", authMiddleware())❌ 错误：传的是调用结果（nil或 panic），不是函数值
为什么不用 Use()：作用域完全不一样
r.Use() 注册的是全局中间件，所有后续注册的路由都会被拦截；而路由级中间件只绑定到当前这一行，哪怕路径相同、方法相同，另一条 r.POST() 也不会触发它。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 想让
GET /user走鉴权，但POST /user不走？只能用路由级写法 - 用
r.Use(auth)后又注册r.POST("/login", loginHandler)—— 登录接口也会被鉴权拦住，通常这不是你想要的 - 注意：
r.Use()的效果从调用那一刻起生效，对它之后注册的所有路由起作用，和路由定义顺序强相关
常见错误：中间件里调了 c.Abort() 却没返回
认证类中间件一旦判断失败，必须 c.AbortWithStatusJSON() + return。漏掉 return，控制流会继续往下走，可能执行 handler，也可能 panic。
- 错误示范：
if !valid { c.AbortWithStatusJSON(401, gin.H{"error": "no token"}) }→ 缺return，后面c.Next()还会执行 - 正确写法：
if !valid { c.AbortWithStatusJSON(401, gin.H{"error": "no token"}); return } - 更安全的做法是把 handler 逻辑包在
if valid { ... }块里，避免遗漏
路由级中间件和路由组中间件的区别
路由组（r.Group("/v1")）的 .Use() 是“局部全局”：组内所有子路由都生效；而单条路由的中间件只属于它自己，哪怕它在某个组里，也不受组级 Use() 影响（除非你显式再传一次）。
-
v1 := r.Group("/v1"); v1.Use(auth); v1.GET("/user", handler)→/v1/user会执行auth -
v1.GET("/user", rateLimit, handler)→ 这里rateLimit会比auth更早执行（洋葱模型：后注册的先执行前置） - 如果同时用了组级
Use()和路由级参数，中间件执行顺序由注册位置决定，不是按字符串顺序排的
最易被忽略的一点：路由级中间件的函数签名必须严格是 func(*gin.Context)，少个 *（写成 func(gin.Context)）会导致编译通过但运行时静默失效——IDE 很难提示，只能靠日志或断点确认是否进了中间件。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
