答案：Go语言通过自定义AppError结构体实现统一错误处理，包含错误码、消息和原因，使用NewAppError函数集中创建错误，并利用%w包装保留错误链；在HTTP中间件中统一处理错误响应，结合context传递trace ID实现日志追溯，使用结构化日志记录错误上下文，提升系统可维护性和稳定性。
在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动词可以保留错误链：
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只需返回错误，由中间件决定如何响应。
日志记录与上下文关联
错误发生时应记录足够上下文以便排查。结合context传递请求ID，能有效串联日志。
建议做法：
- 在请求入口生成唯一trace ID，并存入context
- 记录错误时带上trace ID和相关参数
- 使用结构化日志库（如zap或logrus）输出JSON格式日志
示例：
logger.Error("数据库查询失败",zap.String("trace_id", getTraceID(ctx)),
zap.Int("user_id", userID),
zap.Error(err),
)
基本上就这些。统一错误处理不是一蹴而就的，关键是尽早规划错误模型，保持团队一致，并随着系统演进逐步完善。核心目标是让错误可识别、可追溯、可恢复。
