NoRoute必须在所有路由注册之后调用，因为它是Gin路由树的兜底出口，仅在全部已注册路径与方法均不匹配时触发；若提前注册，后续路由将无法生效。
为什么 NoRoute 必须放在所有路由注册之后
因为 NoRoute 是 Gin 路由树的“兜底出口”，它只在所有已注册的路径 + 方法组合全部不匹配时才触发。如果写在 r.GET() 或 r.Group() 之前，后续注册的路由会覆盖或干扰其注册逻辑——Gin 内部按顺序构建路由树，NoRoute 的处理器必须是最后注册的节点。
- 错误写法：
r.NoRoute(...)放在r.POST("/users", ...)前 → 实际不会生效 - 正确顺序：所有
r.GET、r.POST、r.Group().GET全部完成后再调用r.NoRoute - 哪怕用了
r.Group("/api")，也要等整个分组注册完再挂NoRoute
NoRoute 中必须显式终止响应链
默认情况下，NoRoute 函数体里如果不调用 c.Abort() 或带终止语义的方法，Gin 会继续执行后续中间件（比如日志、recover），最终可能重复写 header 或返回空响应体，甚至触发 panic。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 安全写法：用
c.AbortWithStatusJSON(404, ...)—— 一步到位，自动Abort()并设 status - 次选写法：先
c.JSON(404, ...)再c.Abort()，缺一不可 - 危险写法：只写
c.JSON(404, ...)→ 可能被后续中间件二次写入，HTTP 状态码错乱 - 生产建议：复用你项目里已有的统一错误响应函数，比如
response.Fail(c, http.StatusNotFound, 40401, "not found")
如何区分 API 和前端路由做不同 404 处理
很多项目同时暴露 REST 接口（如 /api/v1/users）和 SPA 页面（如 /、/dashboard），未命中时应返回不同格式：API 返回 JSON，页面重定向到入口或返回 HTML。
- 靠
c.Request.URL.Path做前缀判断即可，例如：strings.HasPrefix(c.Request.URL.Path, "/api/") - 注意大小写：Gin 默认路径匹配是大小写敏感的，
/API/xxx不会被/api/拦截 - 避免硬编码字符串，可提取为常量：
const apiPrefix = "/api/" - 若需支持多版本（
/v1/、/v2/），建议用正则或更健壮的路径解析，而非简单HasPrefix
NoRoute 不处理 405 Method Not Allowed
NoRoute 只捕获“路径不存在”，不负责“路径存在但方法不支持”。比如对已注册的 /users 发起 DELETE 请求，而你只定义了 GET 和 POST，这时触发的是 NoMethod，不是 NoRoute。
- 必须单独注册：
r.NoMethod(func(c *gin.Context) { c.AbortWithStatusJSON(405, gin.H{"error": "method not allowed"}) }) -
NoMethod和NoRoute是两个独立钩子，都要手动设置才能覆盖默认行为 - 两者注册顺序无关，但都应在所有路由注册完成后调用
- 如果既想统一对待 404/405，又不想写两遍逻辑，可以把响应逻辑抽成函数复用
NoRoute 和 NoMethod 都不经过任何中间件（包括你 Use() 的全局中间件），它们是路由引擎最末端的裸处理器。如果你依赖中间件注入 context 数据（如用户身份、请求 ID），在这些兜底函数里是拿不到的——得自己从 c.Request 或 c.Get() 显式取。 
