知识分享之Golang——Gin学习之404、500常用错误配置

背景

知识分享之Golang篇是我在日常使用Golang时学习到的各种各样的知识的记录，将其整理出来以文章的形式分享给大家，来进行共同学习。欢迎大家进行持续关注。

知识分享系列目前包含Java、Golang、Linux、Docker等等。

开发环境

• 系统：windows10
• 语言：Golang
• 组件库：Bleve
• golang版本：1.17
• 组件官网：https://gin-gonic.com/zh-cn/
• 组件仓库：https://github.com/gin-gonic/gin
• 开源协议：MIT License

内容

我们在使用gin时难免有些地址是网关没有的，页面又会被莫名其妙的点击进入，这时就需要统一的404和500错误页面来进行处理，相比500来讲，404在gin中配置就要容易很多了。

1、首先我们在templates/error/下创建好404、500相关错误页面，可以到网上随便找一些符合于自己的模板，然后使用gin的模板加载机制随着其他模板文件一起加载起来。

    // 加载静态资源
    r.StaticFS("/static", http.Dir("./static"))
        // 加载模板文件
    r.LoadHTMLGlob("templates/**/*.html")

2、配置统一的404错误跳转页面

// 加载404错误页面
    r.NoRoute(func(c *gin.Context) {
        // 实现内部重定向
        c.HTML(http.StatusOK, "404.html", gin.H{
            "title": "404",
        })
    })

3、配置统一的500错误页面，由于gin中没有直接配置的，这里我们需要做一个中间件函数来进行处理。

// errorHttp 统一500错误处理函数
func errorHttp(c *gin.Context) {
    defer func() {
        if r := recover(); r != nil {
            //打印错误堆栈信息
            log.Printf("panic: %v\n", r)
            debug.PrintStack()
            //封装通用json返回
            c.HTML(200, "500.html", gin.H{
                "title": "500",
            })
        }
    }()
    c.Next()
}

4、然后在路由中增加上这个中间件

    // 设置500提示中间件
    r.Use(errorHttp)

这样就配置完成了，其他的按照gin的正常配置即可，当遇到500或4040时就会进入我们的模板页面。

本文声明：

知识共享许可协议
本作品由 [cn華少] 采用 知识共享署名-非商业性使用 4.0 国际许可协议 进行许可。