Golang如何在中间件中集中处理error_Golang middleware error管理方法

P粉602998670 2025-11-30 00:00:00 次阅读

定义统一错误类型AppError，通过中间件集中处理error和panic。使用HandlerFunc返回error，defer recover捕获异常，结合context传递上下文信息，实现优雅错误管理。

在Go语言的Web开发中，中间件是处理请求前后的逻辑（如日志、认证、权限校验）的重要组件。当多个Handler中出现错误时，如果每个函数都单独处理error，会导致代码重复且难以维护。因此，在中间件中集中处理error是一种更优雅的做法。

统一错误类型设计

为了便于中间件识别和处理错误，建议定义一个统一的错误接口或结构体，让业务逻辑返回标准化的错误信息。

例如：

type AppError struct {
  Code int
  Msg string
}

func (e AppError) Error() string {
  return e.Msg
}

这样，Handler可以返回 AppError{400, "参数错误"}，中间件能根据 Code 判断是客户端错误还是服务器错误。

使用中间件捕获 panic 和 error

通过 defer 和 recover 可以在中间件中捕获未处理的 panic，并将其转换为 HTTP 响应。同时，可以封装 Handler 函数类型，使其支持返回 error。

定义可返回 error 的 Handler 类型：

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

中间件包装该类型并处理错误：

func ErrorMiddleware(next HandlerFunc) http.HandlerFunc {
  return func(w http.ResponseWriter, r *http.Request) {
    defer func() {
      if err := recover(); err != nil {
        log.Printf("Panic: %v", err)
        http.Error(w, "Internal Server Error", 500)
      }
    }()

    if err := next(w, r); err != nil {
      if appErr, ok := err.(AppError); ok {
        http.Error(w, appErr.Msg, appErr.Code)
      } else {
        log.Printf("Unexpected error: %v", err)
        http.Error(w, "Internal Server Error", 500)
      }
    }
  }
}

在业务Handler中返回错误

使用封装后的 HandlerFunc，可以在业务逻辑中直接 return 错误，由中间件统一处理。

func GetUser(w http.ResponseWriter, r *http.Request) error {
  id := r.URL.Query().Get("id")
  if id == "" {
    return AppError{400, "Missing user id"}
  }
  // ... 处理业务逻辑
  return nil
}

注册路由时使用中间件包装：

http.HandleFunc("/user", ErrorMiddleware(GetUser))