如何在Golang中实现统一错误处理策略-Golang-PHP中文网

如何在Golang中实现统一错误处理策略

P粉602998670

发布： 2025-10-15 14:53:01

原创

261人浏览过

答案：Go语言通过自定义AppError结构体实现统一错误处理，包含错误码、消息和原因，使用NewAppError函数集中创建错误，并利用%w包装保留错误链；在HTTP中间件中统一处理错误响应，结合context传递trace ID实现日志追溯，使用结构化日志记录错误上下文，提升系统可维护性和稳定性。

如何在golang中实现统一错误处理策略

在Go语言中，错误处理是程序设计的重要部分。由于Go不使用异常机制，而是通过返回error类型来传递错误信息，因此建立统一的错误处理策略对提升代码可维护性和系统稳定性非常关键。

定义一致的错误类型结构

为便于识别和处理错误，建议定义一个结构化的错误类型，包含错误码、消息、级别等信息。

例如：

type AppError struct {
  Code int
  Message string
  Cause error
}

func (e *AppError) Error() string {
  if e.Cause != nil {
    return e.Message + ": " + e.Cause.Error()
  }
  return e.Message
}

这样可以在不同层级（如HTTP handler、service、repository）使用相同的错误语义。比如用Code区分是参数错误（400）、权限问题（403）还是系统错误（500）。

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

集中创建和包装错误

避免在多处重复构造错误，应提供统一的错误生成函数。

例如：

var (
  ErrNotFound = &AppError{Code: 404, Message: "资源未找到"}
  ErrInvalidInput = &AppError{Code: 400, Message: "输入参数无效"}
)

func NewAppError(code int, message string, cause error) *AppError {
  return &AppError{
    Code: code,
    Message: message,
    Cause: cause,
  }
}

// 使用示例
if user == nil {
  return nil, ErrNotFound
}

借助fmt.Errorf配合%w动词可以保留错误链：

挖错网

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

查看详情

if err != nil {
return fmt.Errorf("读取用户数据失败: %w", err)
}

中间件或拦截器统一处理错误响应

在Web服务中，可在HTTP中间件中捕获并格式化错误输出，避免每个handler重复写响应逻辑。

例如：

func ErrorHandler(next http.HandlerFunc) http.HandlerFunc {
  return func(w http.ResponseWriter, r *http.Request) {
    defer func() {
      if rec := recover(); rec != nil {
        respondWithError(w, 500, "系统内部错误")
      }
    }()

    next(w, r)
  }
}

func respondWithError(w http.ResponseWriter, code int, message string) {
  w.Header().Set("Content-Type", "application/json")
  w.WriteHeader(code)
  json.NewEncoder(w).Encode(map[string]interface{}{
    "error": message,
    "code": code,
  })
}

业务handler只需返回错误，由中间件决定如何响应。