NoRoute必须在所有GET/POST等路由注册之后调用，因其仅匹配前面所有路由均未命中的请求；若提前注册，则后续路由永不执行。
为什么 NoRoute 必须在所有 GET/POST 路由注册之后调用
因为 NoRoute 是 Gin 的兜底机制，它只对「前面所有路由都未匹配」的请求生效。如果把它写在 r.GET("/user", ...) 之前，那所有请求（包括 /user）都会被直接捕获，后续路由永远不执行。
常见错误写法：
r.NoRoute(func(c *gin.Context) {
c.JSON(404, gin.H{"error": "not found"})
})
r.GET("/user", handler) // ← 这个永远不会被访问到
- 务必把
NoRoute放在所有r.GET、r.POST、r.Group等路由注册语句的最末尾 - 如果你用了
r.Group，也要确保整个分组注册完再挂NoRoute - 中间件不影响
NoRoute触发时机——它只看路由树是否匹配，不看中间件是否 panic
如何让 NoRoute 返回 JSON 而不是默认 HTML 页面
Gin 默认的 NoRoute 不做任何响应，如果你没手动调用 c.AbortWithStatusJSON 或类似方法，Gin 会继续往下走，最终触发 HTTP 标准 404 响应体（通常是空 body 或内置 HTML）。这不是 bug，是设计使然。
正确做法是显式终止并返回：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
r.NoRoute(func(c *gin.Context) {
c.AbortWithStatusJSON(404, gin.H{
"code": 404,
"message": "endpoint not found",
"path": c.Request.URL.Path,
})
})
- 必须调用
c.AbortWithStatusJSON、c.JSON+c.Abort()，或至少c.Status(404)+c.Abort() - 避免只写
c.JSON(404, ...)而不Abort()：某些中间件（比如日志或 recover）可能还会执行，导致重复写 header - 如果项目统一返回结构体，建议在这里复用你的标准 error response 封装函数
在 NoRoute 中区分 API 路径和静态资源路径
很多项目同时提供 REST API（/api/v1/xxx）和前端页面（/assets/、/ 或 /app/*），你可能希望 API 未命中时返回 JSON 错误，而页面路径未命中时重定向到 SPA 入口或返回 404 HTML。
靠 c.Request.URL.Path 做前缀判断即可：
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.Redirect(http.StatusFound, "/index.html")
}
})
- 注意字符串比较要小心大小写，
/API/和/api/是不同路径 - 不要依赖
c.FullPath()，它在未匹配路由时为空字符串 - 如果用了
StaticFS或StaticFile，它们本身不参与路由匹配，所以NoRoute仍会触发——需提前用r.Static注册静态目录，让 Gin 内部优先处理
调试时怎么确认是不是真进了 NoRoute
最直接的办法是在 NoRoute 处理函数里加一行日志，并确保日志能输出（比如用 log.Printf 或 Gin 的 c.Logger().Info）：
r.NoRoute(func(c *gin.Context) {
log.Printf("[NoRoute] %s %s from %s", c.Request.Method, c.Request.URL.Path, c.ClientIP())
c.AbortWithStatusJSON(404, gin.H{"error": "not found"})
})
- 别只靠浏览器 F5 刷新看状态码——有些前端框架会拦截 404 并跳转，实际请求可能已被代理或缓存
- 用
curl -v http://localhost:8080/xxx查看真实响应头和 body - 如果日志没打印但返回了 404，说明根本没进
NoRoute，而是某个中间件（如自定义 auth）提前Abort()了
真正容易被忽略的是：Gin 的路由匹配是严格区分 method 的。POST /user 没注册，但你用 GET 访问 /user，它不会进 NoRoute —— 因为 GET /user 可能根本没定义，这时才进；而 POST /user 未定义，Gin 默认返回 405 Method Not Allowed，不走 NoRoute。
