Golang中间件error集中处理方法

定义统一错误类型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。

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))

结合 context 传递错误上下文（可选）

对于需要记录更多错误信息（如 trace ID）的场景，可通过 context 向下传递上下文，并在中间件中提取附加信息。

比如在中间件中生成 requestID，出错时一并打印，有助于排查问题。

基本上就这些。通过自定义错误类型、封装Handler、使用中间件recover和拦截error，Golang可以实现清晰的错误管理机制，避免散落在各处的 if err != nil，提升代码可读性和维护性。不复杂但容易忽略。