Golang中使用Gin框架自定义HTTP错误页面-Golang-PHP中文网

gin默认不渲染404/500页面，因其default()和new()实例仅注册基础中间件，recovery()捕获panic但不处理状态码响应体，未匹配路由时直接返回纯文本“404 page not found”，需用noroute()注册兜底路由并手动调用c.html(404, "404.html", data)渲染自定义页面。

golang中使用gin框架自定义http错误页面

为什么Gin默认不渲染404/500页面？

Gin的Default()和New()实例默认只注册基础中间件，Recovery()捕获panic但不处理HTTP状态码，Static()或路由未匹配时直接返回空响应+状态码，没有HTML模板渲染逻辑。这意味着404、500等错误仍走标准Go HTTP的纯文本响应（如"404 page not found"），不是你想要的自定义页面。

如何让Gin在404时返回HTML页面？

核心是拦截未匹配路由，并手动写入HTML响应。不能依赖NotFound()中间件——它只是设置状态码，不接管响应体：

在所有路由注册后，用router.NoRoute()定义兜底路由，而不是router.Use(gin.Recovery())之后再写router.GET("/404", ...)
NoRoute()必须放在router.Group()和router.Handle()之后，否则会被覆盖
推荐用html/template预编译模板，避免每次请求都解析；路径如"./templates/404.html"需确保运行时可读

示例：

router.NoRoute(func(c *gin.Context) {
    c.HTML(404, "404.html", gin.H{"Title": "Page Not Found"})
})

500错误怎么统一捕获并渲染？

Recovery()中间件会recover panic并写日志，但它不控制响应内容。要渲染HTML，得自己重写RecoveryWithWriter()：

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

传入自定义io.Writer不可行，应改用RecoveryWithWriter()的recoveryFunc参数
函数签名必须为func(*gin.Context, interface{})，内部调用c.HTML(500, "500.html", ...)
注意：panic发生时，response writer可能已被部分写入，c.Abort()后调用c.HTML()才安全

示例：

router.Use(gin.RecoveryWithWriter(
    gin.DefaultErrorWriter,
    func(c *gin.Context, err interface{}) {
        c.Abort()
        c.HTML(500, "500.html", gin.H{"Error": err})
    },
))

静态资源404和模板路径错误容易混淆

两类404需区分处理：

API接口未定义 → 由NoRoute()捕获，走HTML模板
静态文件（如/static/js/app.js）不存在 → Gin的router.Static()内部用http.ServeFile，触发的是标准http.NotFound，不会进NoRoute()
模板文件本身缺失（如"404.html"没找到）→ c.HTML()会panic，触发Recovery，形成嵌套错误，页面显示空白或原始panic信息