首页 > Golang > Go教程

Golang错误处理中间件封装教程

时间：2025-09-01 09:35:48 500浏览收藏

在Go Web服务开发中，统一的错误处理机制至关重要。本文提供一份**Golang错误处理中间件统一封装指南**，旨在提升代码可维护性和接口规范性。通过定义`ErrorResponse`结构体，实现标准化的错误响应格式，方便前后端协作与调试。利用`ErrorMiddleware`中间件捕获`panic`，结合`sendErrorResponse`函数，封装错误输出，确保无论程序发生何种错误，都能返回统一的JSON格式。本文还将介绍如何在handler中使用`panic`或`sendErrorResponse`主动返回错误，并将中间件应用到路由，从而实现Go Web服务的统一错误处理，让你的API服务更加健壮可靠。

定义统一错误响应结构体ErrorResponse，通过ErrorMiddleware中间件捕获panic并返回标准化JSON，结合sendErrorResponse函数封装错误输出，在handler中使用panic或sendErrorResponse主动返回错误，最后将中间件应用到路由，实现Go Web服务的统一错误处理。

Golang错误处理中间件统一错误格式封装

在Go语言开发中，错误处理是Web服务不可或缺的一部分。使用中间件对错误进行统一处理，可以提升代码的可维护性和接口的规范性。通过封装统一的错误响应格式，前后端协作更高效，调试也更方便。

定义统一的错误响应格式

首先，定义一个结构体来表示API返回的标准化错误信息：

type ErrorResponse struct {
    Code    int         `json:"code"`
    Message string      `json:"message"`
    Data    interface{} `json:"data,omitempty"`
}

Code 表示业务或HTTP状态码，Message 是可读的提示信息，Data 可选，用于携带附加信息（如调试详情）。

实现错误处理中间件

中间件的作用是捕获后续处理函数中可能发生的错误，并返回标准化的JSON响应。

func ErrorMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        // 使用defer+recover捕获panic
        defer func() {
            if err := recover(); err != nil {
                // 判断是否为已知错误类型，或直接作为服务器内部错误
                var errorMsg string
                switch e := err.(type) {
                case string:
                    errorMsg = e
                case error:
                    errorMsg = e.Error()
                default:
                    errorMsg = "unknown error"
                }

                sendErrorResponse(w, http.StatusInternalServerError, "Internal Server Error", nil)
            }
        }()

        next.ServeHTTP(w, r)
    })
}

// sendErrorResponse 封装响应输出
func sendErrorResponse(w http.ResponseWriter, code int, message string, data interface{}) {
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(code)

    resp := ErrorResponse{
        Code:    code,
        Message: message,
        Data:    data,
    }

    json.NewEncoder(w).Encode(resp)
}

在业务中主动返回错误

在Handler中，可以通过 panic 自定义错误，或者调用统一函数返回错误，避免重复写JSON逻辑。

例如：

func userHandler(w http.ResponseWriter, r *http.Request) {
    userId := r.URL.Query().Get("id")
    if userId == "" {
        panic("user id is required")
    }

    // 模拟业务错误
    if userId == "0" {
        sendErrorResponse(w, http.StatusBadRequest, "Invalid user id", nil)
        return
    }

    fmt.Fprintf(w, `{"data": "user %s"}`, userId)
}

也可以定义错误类型，比如 BusinessError，在中间件中做类型判断，实现更精细的控制。

集成到HTTP服务

将中间件应用到路由：

http.Handle("/user", ErrorMiddleware(http.HandlerFunc(userHandler)))
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))

这样，无论是在处理过程中 panic，还是主动调用 sendErrorResponse，客户端收到的都是统一格式的JSON错误响应。

基本上就这些。通过中间件 + panic recover + 统一封装，可以实现简洁、统一的Golang错误处理机制，适合中小型API服务快速落地。

到这里，我们也就讲完了《Golang错误处理中间件封装教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于中间件,panic,Golang错误处理,ErrorResponse,统一封装的知识点！

中间件 panic Golang错误处理 ErrorResponse 统一封装