noroute必须放在所有路由注册之后，因为它是gin的兜底机制，仅在所有已注册的get、post等路由均未匹配时触发；若提前注册，后续业务路由将被拦截而无法执行。
为什么 NoRoute 必须放在所有路由注册之后
因为 NoRoute 是 Gin 的兜底机制，不是普通路由。它只在所有已注册的 r.GET、r.POST、r.Group 都不匹配时才触发。如果提前注册，后续添加的业务路由会被它拦截——比如你先写 r.NoRoute(...)，再写 r.GET("/user", handler)，那 /user 永远不会被访问到。
常见错误现象：本地测试 404 页面能显示，但上线后所有请求都进 NoRoute，就是顺序错了。
- 必须严格遵循“先注册业务路由，最后调用
r.NoRoute” - 用了
r.Group也要等整个分组注册完再挂NoRoute -
NoRoute不参与路由树匹配，也不受中间件影响（哪怕中间件 panic，它照样触发）
如何让 NoRoute 返回 HTML 而不是纯文本
Gin 默认的 404 响应是硬编码的字符串 "404 page not found"，根本不走模板引擎。想渲染 404.html，必须手动调用 c.HTML()，并确保模板已加载。
关键点：没调 LoadHTMLFiles 或 LoadHTMLGlob 就用 c.HTML，会直接 panic。
- 加载模板：用
r.LoadHTMLGlob("templates/**.html")或明确列出r.LoadHTMLFiles("templates/404.html", "templates/base.html") - 渲染时显式传入状态码：
c.HTML(404, "404.html", gin.H{"path": c.Request.URL.Path})，否则默认是 200 - 模板里只能用传入的 key，比如
{{.path}}；不能写{{.Request.URL.Path}}，上下文已脱离 handler 执行栈
如何在 NoRoute 中区分 API 和页面请求
很多项目同时提供 JSON API（如 /api/v1/users）和前端页面（如 /、/app/*），404 响应格式应该不同：API 返回 JSON，页面返回 HTML 或重定向到 SPA 入口。
靠 c.Request.URL.Path 做前缀判断最直接，但要注意大小写和边界。
- 判断 API 路径：
strings.HasPrefix(c.Request.URL.Path, "/api/") - 判断静态资源或前端路由：
!strings.HasPrefix(c.Request.URL.Path, "/api/") && !strings.HasPrefix(c.Request.URL.Path, "/static/") - 返回 HTML：
c.HTML(404, "404.html", ...)；返回 JSON：c.AbortWithStatusJSON(404, ...)；重定向：c.Redirect(http.StatusFound, "/index.html") - 避免只调
c.JSON不c.Abort()：某些中间件（如日志、recover）可能继续执行，导致 header 重复写入
NoRoute 无法捕获 405 Method Not Allowed
NoRoute 只处理“路径 + 方法”双重不匹配，比如对 /users 发 GET 请求但没注册 GET，或对 /unknown 发任意方法。但它不管“路径存在、方法不支持”的情况——那是 NoMethod 的职责。
比如你只注册了 r.GET("/users")，然后用 POST 访问 /users，NoRoute 不会触发，而是返回默认 405 响应。
- 要统一处理 405，得额外注册：
r.NoMethod(func(c *gin.Context) { c.AbortWithStatusJSON(405, gin.H{"error": "method not allowed"}) }) -
NoMethod和NoRoute是两个独立钩子，必须分别注册 - 两者都不影响中间件执行顺序，只取决于路由匹配结果
NoRoute 解决不了方法不支持的问题，而很多人以为加了兜底就万事大吉。
