Golang在Web服务中统一错误处理方法-Golang-PHP中文网

Golang在Web服务中统一错误处理方法

P粉602998670

发布： 2025-09-07 11:04:01

原创

398人浏览过

定义统一错误类型AppError并结合中间件实现集中处理，通过自定义HandlerFunc返回error，由ErrorHandler中间件统一输出JSON格式错误响应，避免重复代码，提升可维护性与API稳定性。

golang在web服务中统一错误处理方法

在Go语言开发的Web服务中，统一错误处理能提升代码可维护性、增强API的稳定性，并让客户端更容易理解错误原因。直接在每个Handler中写错误处理逻辑会导致重复代码，也不利于全局监控和日志记录。以下是实现统一错误处理的核心思路和实用方法。

定义统一的错误类型

使用自定义错误类型可以标准化错误输出，便于JSON响应和状态码管理。

type AppError struct {
Code int `json:"code"`
Message string `json:"message"`
}

这样可以在返回时统一结构：

func (e *AppError) Error() string {
return e.Message
}

例如：

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

ErrNotFound = &AppError{Code: 404, Message: "资源未找到"}

使用中间件统一捕获错误

通过包装Handler函数，将返回值设为 error 类型，把错误传递到中间件处理。

Motiff妙多

Motiff妙多是一款AI驱动的界面设计工具，定位为“AI时代设计工具”

250

查看详情

type HandlerFunc func(http.ResponseWriter, *http.Request) error

然后定义一个适配器，把自定义的 HandlerFunc 转成标准的 http.HandlerFunc：

func ErrorHandler(h HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        if err := h(w, r); err != nil {
            if appErr, ok := err.(*AppError); ok {
                http.Error(w, fmt.Sprintf(`{"code":%d,"message":"%s"}`, appErr.Code, appErr.Message), appErr.Code)
            } else {
                http.Error(w, `{"code":500,"message":"服务器内部错误"}`, 500)
                log.Printf("Internal error: %v", err)
            }
        }
    }
}

这样你的业务Handler就可以返回 error，由中间件统一处理：

func GetUser(w http.ResponseWriter, r *http.Request) error {
    id := r.URL.Query().Get("id")
    if id == "" {
        return &AppError{Code: 400, Message: "缺少用户ID"}
    }
    // 模拟查不到用户
    return ErrNotFound
}