Golang如何统一处理HTTP错误设计中间件捕获路由错误-Golang-PHP中文网

Golang如何统一处理HTTP错误设计中间件捕获路由错误

P粉602998670

发布： 2025-08-25 11:33:01

原创

715人浏览过

使用中间件统一处理Go HTTP错误，通过定义ErrorResponse结构和ErrorMiddlewareAdv函数，结合defer/recover捕获panic，推荐用error返回替代panic，实现错误集中处理。

golang如何统一处理http错误设计中间件捕获路由错误

在 Go 的 HTTP 服务中，统一处理错误是提升代码可维护性和 API 一致性的关键。通过设计中间件捕获路由处理函数中的错误，可以避免在每个 handler 中重复写错误响应逻辑。

使用中间件统一处理错误

Go 的 net/http 本身不提供异常机制，但可以通过中间件包装 handler，利用 defer 和 recover 捕获 panic，同时定义统一的错误响应格式。

核心思路是：创建一个装饰器函数，将普通的

http.HandlerFunc

登录后复制

包装成能自动处理错误的版本。

示例：定义统一错误响应结构

type ErrorResponse struct {
    Error   string `json:"error"`
    Status  int    `json:"status"`
}

登录后复制

示例：错误处理中间件

func ErrorMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        // 捕获 panic
        defer func() {
            if err := recover(); err != nil {
                var errorMsg string
                var statusCode = http.StatusInternalServerError

                switch e := err.(type) {
                case string:
                    errorMsg = e
                case error:
                    errorMsg = e.Error()
                default:
                    errorMsg = "internal server error"
                }

                log.Printf("Panic: %v", errorMsg)
                sendErrorResponse(w, statusCode, errorMsg)
            }
        }()

        // 正常执行 handler
        next(w, r)
    }
}

func sendErrorResponse(w http.ResponseWriter, status int, message string) {
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(status)
    json.NewEncoder(w).Encode(ErrorResponse{
        Error:  message,
        Status: status,
    })
}

登录后复制

在路由中使用错误中间件

将业务 handler 用中间件包装，即可自动处理错误。

立即学习“go语言免费学习笔记（深入）”；

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

查看详情

示例：注册路由

func main() {
    http.HandleFunc("/user", ErrorMiddleware(func(w http.ResponseWriter, r *http.Request) {
        if r.Method != "GET" {
            panic("method not allowed")
        }

        // 模拟业务错误
        if someCondition {
            panic("user not found")
        }

        fmt.Fprintf(w, `{"data": "ok"}`)
    }))

    http.ListenAndServe(":8080", nil)
}

登录后复制

主动返回错误而非 panic

虽然 panic 能被 recover 捕获，但更推荐通过返回 error 来控制流程，保持程序稳定性。

改进：使用 error 返回代替 panic

type HttpHandler func(w http.ResponseWriter, r *http.Request) error

func ErrorMiddlewareAdv(next HttpHandler) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        if err := next(w, r); err != nil {
            log.Printf("Handler error: %v", err)
            sendErrorResponse(w, http.StatusInternalServerError, err.Error())
        }
    }
}

// 使用示例
http.HandleFunc("/data", ErrorMiddlewareAdv(func(w http.ResponseWriter, r *http.Request) error {
    if r.Header.Get("Authorization") == "" {
        return errors.New("missing auth header")
    }
    fmt.Fprintf(w, `{"result": "success"}`)
    return nil
}))

登录后复制

这种方式更清晰，避免滥用 panic，同时仍能统一处理错误。

基本上就这些。中间件 + error 返回 + 统一响应格式，是 Go 中处理 HTTP 错误的简洁可靠方案。

以上就是Golang如何统一处理HTTP错误设计中间件捕获路由错误的详细内容，更多请关注php中文网其它相关文章！