NoRoute 是 Gin 处理未匹配路由的唯一可靠方式，必须在所有 r.GET/r.POST/r.Group 等路由注册之后显式调用，通过路径前缀（如 /api/）可区分返回 JSON 或 HTML，并需提前加载模板且传入 gin.H 数据。
NoRoute 是 Gin 处理未知路由的唯一可靠方式，没有配置项、没有中间件开关，必须显式注册且位置严格——它不是“增强功能”，而是框架兜底逻辑的强制入口。
为什么 NoRoute 必须放在所有路由注册之后
因为 NoRoute 的触发条件是「前面所有 r.GET、r.POST、r.Group 均未匹配」。一旦顺序写错，比如：
r.NoRoute(handle404)
r.GET("/user", userHandler) // 永远不会执行
所有请求都会被 NoRoute 拦截，后续路由形同虚设。实际项目中常见于：
- 把
NoRoute写在r.Group块内部（应写在分组注册完之后） - 在热重载或模块化路由加载时，误将
NoRoute注册到子 router 而非根 engine - 用
router.Any("/*path", ...)替代NoRoute，结果干扰正常路由树匹配
NoRoute 中如何区分 API 和页面请求
多数项目同时暴露 REST 接口（如 /api/v1/users）和前端资源（如 /、/app/*），不能统一返回 JSON 或 HTML。靠路径前缀判断最直接：
立即学习“go语言免费学习笔记（深入）”；
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
r.NoRoute(func(c *gin.Context) {
path := c.Request.URL.Path
if strings.HasPrefix(path, "/api/") {
c.AbortWithStatusJSON(404, gin.H{"error": "API endpoint not found"})
} else {
c.HTML(404, "404.html", gin.H{"url": path})
}
})
注意点：
- 字符串比较区分大小写，
/API/和/api/是两个路径 - 不要用正则匹配路径前缀——性能差且易出错，
strings.HasPrefix足够安全 - 若使用 SPA，可对非 API 路径
c.Redirect(http.StatusFound, "/index.html")，但需确保前端路由能接管
模板渲染 404 页面时数据怎么传进去
Gin 模板里无法调用 c.Param() 或 c.Request，所有变量必须提前塞进 gin.H 传入：
r.LoadHTMLGlob("templates/**/*.html")
r.NoRoute(func(c *gin.Context) {
c.HTML(404, "404.html", gin.H{
"title": "Page Not Found",
"path": c.Request.URL.Path,
"time": time.Now().Format("2006-01-02"),
})
})
关键限制：
-
LoadHTMLFiles或LoadHTMLGlob必须在NoRoute之前调用，否则运行时 panic - 模板中访问
.path没问题，但不能写{{.c.Request.URL.Path}}—— 渲染时c已脱离 handler 上下文 - 如果用了自定义 layout（如
base.html），确保404.html正确{{template "base" .}}
真正容易被忽略的是：Gin 的 NoRoute 不处理方法不匹配（比如对 /users 发起 DELETE 但只注册了 GET）。这种场景需要额外配 NoMethod，但它和 NoRoute 是独立触发的，且必须同时注册才有效。
