gin框架中noroute用于统一处理404，必须在所有路由注册后调用，仅捕获路径不匹配请求，不处理panic或业务错误；405由框架自动返回，不可通过noroute捕获。
Gin 框架里没有“HTTP 错误路由”这个概念，它不支持像 Express 的 app.use((err, req, res, next) => {}) 那样的错误中间件自动捕获 panic 或业务错误。真正能自定义的，只有两类兜底行为：未匹配路由（404） 和 方法不被允许（405）——而后者通常靠你注册完整的方法集来规避，不是靠“错误路由”。
所以如果你看到 404 响应不符合预期，或者想统一返回 JSON 而不是默认的纯文本，问题几乎都出在 NoRoute 配置上。
为什么 NoRoute 必须放在所有路由注册之后
NoRoute 不是中间件，也不是 fallback 中间件，它是 Gin 路由树匹配失败后的最终处理器。一旦你把它写在 r.GET 前面，后面所有路由就永远不会被执行——因为请求先撞上 NoRoute 就结束了。
- 正确顺序：
r.GET、r.POST、r.Group全部写完，最后才调用r.NoRoute(...) - 错误写法：
r.NoRoute(...)放在r.GET("/ping", ...)上面 → 所有请求都 404 - 它只触发一次，且不经过任何已注册中间件（包括 Logger、Auth），所以日志、鉴权等逻辑不会生效
NoRoute 处理器里怎么返回 JSON 而不是 HTML 或纯文本
Gin 默认的 404 是纯文本响应，但你完全可以用 c.JSON、c.IndentedJSON 或 c.AbortWithStatusJSON 替换它。关键是别漏掉状态码，且避免混用响应方法（比如先 c.String 又 c.JSON）。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 推荐写法：
c.AbortWithStatusJSON(http.StatusNotFound, gin.H{"code": 404, "msg": "not found"}) - 不要写
c.JSON(200, ...)—— 状态码必须是http.StatusNotFound（即 404） - 如果用了
c.Redirect或c.Data，要确保没其他响应已写出，否则会 panic：“write on closed body”
405 Method Not Allowed 是谁在报？能自定义吗
Gin 不提供 NoMethod 这类钩子，405 是框架底层自动返回的：当你访问 /user/123，但只注册了 r.GET("/user/:id", ...)，没注册 r.POST，此时发 POST 请求就会触发 405。它无法被 NoRoute 捕获，也不走任何用户处理器。
- 唯一可控方式：用
r.Any("/user/:id", ...)手动接管所有方法，再在 handler 里用c.Request.Method分支处理 - 或提前注册所有可能方法（哪怕只是返回 405 JSON）：
r.OPTIONS、r.HEAD等也别漏 - 注意：
r.Any会覆盖NoRoute对该路径的兜底，所以它本质是“主动声明该路径存在”，不是错误处理
重定向和尾斜杠陷阱会让 NoRoute 失效
Gin 默认开启 RedirectTrailingSlash，这意味着访问 /api/v1/users/（带尾斜杠）会被 301 重定向到 /api/v1/users。如果后者没路由，才会进 NoRoute；但如果重定向目标本身存在，你就根本看不到 404。
- 调试时先关掉它：
r := gin.New()+ 手动加中间件，或启动前设置：gin.SetMode(gin.ReleaseMode)并禁用重定向 - 更稳妥的做法：统一约定 API 不带尾斜杠，并在 Nginx / LB 层做标准化，别依赖 Gin 自动修正
- 大小写敏感默认开启，
/User和/user是两个路由 ——NoRoute只对完全不匹配的路径生效，不负责拼写纠错
真正容易被忽略的是：NoRoute 不是错误处理器，它只管“路径不存在”。业务层抛 panic、校验失败、数据库超时……这些全得靠 Recovery 中间件或自定义 error handler 捕获，跟 NoRoute 完全无关。
