必须在NoRoute中手动提取请求路径和时间并传入gin.H,模板内不可访问c.Request;需提前调用LoadHTMLFiles加载模板,且c.HTML首参必须为404确保状态码正确。

模板里怎么让 404 页面显示请求路径和时间
默认的 NoRoute 处理器不经过模板引擎,所以必须手动传参。你不能在 HTML 模板里写 {{.Request.URL.Path}} —— 渲染时上下文已脱离 handler 执行栈,c.Request 不可用。
所有动态数据都得在 NoRoute 函数里提前提取并塞进 gin.H:
-
c.Request.URL.Path获取原始请求路径 -
time.Now().Format("2006-01-02 15:04:05")生成格式化时间字符串 -
c.GetHeader("User-Agent")或c.ClientIP()可选补充信息
示例:
router.NoRoute(func(c *gin.Context) {
c.HTML(404, "404.html", gin.H{
"path": c.Request.URL.Path,
"time": time.Now().Format("2006-01-02 15:04:05"),
"ip": c.ClientIP(),
})
})
为什么 LoadHTMLFiles 必须在 NoRoute 前调用
NoRoute 触发时会直接调用 c.HTML,而 c.HTML 内部依赖引擎已加载的模板缓存。如果 LoadHTMLFiles 或 LoadHTMLGlob 没执行,c.HTML 会 panic 报错:template: "404.html" is undefined。
常见顺序错误:
- 先
NoRoute,后LoadHTMLFiles→ 启动就 panic - 只加载
base.html,但没加载404.html→ 运行时报未定义模板 - 路径写错,比如
"templates/404.tmpl"而实际是.html→ 同样报未定义
建议统一用 LoadHTMLGlob("templates/**/*.html"),避免漏文件。
NoRoute 返回 HTML 时状态码必须显式设为 404
Gin 的 c.HTML 默认写入状态码 200。如果你不传第一个参数(或传 200),浏览器看到的是 200 OK,SEO 和前端逻辑都会误判。
正确写法只有这一种:
c.HTML(404, "404.html", gin.H{...})
错误写法包括:
-
c.HTML(200, "404.html", ...)→ 状态码错 -
c.String(404, "...")→ 绕过模板,纯文本 -
c.Redirect(404, "/404")→ 重定向不是 404,且可能触发循环
500 错误页面不能靠 NoRoute 捕获
NoRoute 只处理「路径不匹配」,它对 panic、数据库超时、空指针等 500 类错误完全无感。想让 500 也走模板页,必须自己实现 recovery 中间件,并在 recover 后手动调用 c.HTML(500, "500.html", ...)。
关键点:
- 禁用
gin.Default()(它自带 recovery,但只打日志不渲染模板) - 用
gin.New()+ 自定义CustomRecovery() - recover 后不要调
c.JSON或c.AbortWithStatusJSON,改用c.HTML(500, ...) - 确保
500.html已被LoadHTMLFiles加载
最容易忽略的是:500 页面的数据字段(如错误消息)必须在中间件里提取并传入,模板里拿不到堆栈或 panic 值 —— 它们只存在于 defer 函数作用域内。


















