Golang中间件错误处理技巧

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《Golang中间件统一错误处理方法》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

通过中间件统一处理Golang Web服务中的panic和业务错误，可提升稳定性和可维护性。利用defer+recover捕获异常，防止程序崩溃，并结合自定义错误响应结构体统一返回格式，便于前端解析。在net/http中使用装饰器模式包装Handler，在Gin等框架中则利用其内置中间件机制，如c.Next()后读取c.Errors进行错误响应。核心是通过中间件链集中处理各类错误，避免重复代码，确保服务健壮。

在Golang的Web服务开发中，中间件统一错误处理能有效避免重复代码，提升程序健壮性和可维护性。通过中间件捕获处理HTTP请求过程中的panic和自定义错误，可以统一返回格式、记录日志并防止服务崩溃。

使用中间件捕获panic

Go的http handler中一旦发生未处理的panic，会导致整个程序崩溃。中间件可以通过recover机制拦截这些异常。

基本思路是在每个请求开始时设置defer函数调用recover，一旦发生panic，recover会捕获它并进行处理，而不是让程序终止。

func RecoverMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        defer func() {
            if err := recover(); err != nil {
                log.Printf("panic recovered: %v", err)
                http.Error(w, "Internal Server Error", http.StatusInternalServerError)
            }
        }()
        next.ServeHTTP(w, r)
    })
}

统一返回错误响应

除了捕获panic，中间件还可以处理业务逻辑中主动抛出的错误，比如数据库查询失败、参数校验不通过等。通过封装响应结构，使所有错误返回格式一致。

建议定义通用的错误响应结构体，便于前端解析。

type ErrorResponse struct {
    Error   string `json:"error"`
    Code    int    `json:"code"`
}

func ErrorHandlingMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        // 调用实际的handler
        err := next(w, r)
        if err != nil {
            w.Header().Set("Content-Type", "application/json")
            w.WriteHeader(httpStatusFromError(err))
            json.NewEncoder(w).Encode(ErrorResponse{
                Error: err.Error(),
                Code:  httpStatusFromError(err),
            })
        }
    }
}

注意：上述写法需要handler返回error类型，而不是直接调用http.Error。

与具体框架结合（如net/http或Gin）

不同Web框架对中间件的支持略有差异，但核心思想相同。

• 原生net/http：使用装饰器模式包装Handler，如上文RecoverMiddleware所示
• Gin框架：使用gin.Context的middleware机制，调用c.Next()后通过c.Errors获取错误

func ErrorHandler() gin.HandlerFunc {
    return func(c *gin.Context) {
        c.Next() // 处理请求
        if len(c.Errors) > 0 {
            err := c.Errors[0]
            c.JSON(http.StatusInternalServerError, gin.H{
                "error": err.Error(),
            })
        }
    }
}

基本上就这些。关键在于利用defer+recover机制捕获运行时异常，并通过中间件链控制响应流程，实现错误集中处理。这样既保证了服务稳定性，又提高了代码复用性。不复杂但容易忽略细节，比如recover必须在defer中调用，否则无效。

今天关于《Golang中间件错误处理技巧》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于golang,中间件的内容请关注golang学习网公众号！