定义统一错误 结构体 appError，包含错误码、消息、时间戳和调用 堆栈 ，并通过 NewAppError 构造函数 实例化；集成 zap 等结构化日志库记录 jsON 格式日志，便于elk 或 Loki 解析；在 gin 等 Web 框架中使用 中间件 全局捕获错误并写入日志，同时确保 API 返回一致的错误格式；建议使用 errors.Wrap 保留错误上下文，按级别区分错误类型并配置告警，对外部调用错误进行统一包装与记录，实现标准化错误处理流程。
在 go 语言项目中，统一错误日志的关键在于结构化记录错误信息、标准化错误类型，并结合日志库进行上下文追踪。以下是实现方式的核心要点。
定义统一的错误类型
使用自定义错误结构体，携带错误码、消息、时间戳和调用堆 栈等信息，便于后续分析。
type AppError struct {Code int `json:"code"` Message string `json:"message"` Time time.Time `json:"time"` Trace string `json:"trace,omitempty"` } func (e *AppError) Error() string { return fmt.Sprintf("[%d] %s at %s", e.Code, e.Message, e.Time.Format(time.RFC3339)) }
通过构造函数创建一致的错误实例：
func NewAppError(code int, message string) *AppError {return &AppError{ Code: code, Message: message, Time: time.Now(), Trace: getTrace(), // 可选：runtime.Caller 获取调用栈} }
集成结构化日志库
使用如 zap 或 logrus 这类支持结构化输出的日志库，能更好地记录错误上下文。
立即学习“go 语言免费学习笔记（深入）”；
以 zap 为例：
logger, _ := zap.NewProduction() defer logger.Sync() // 记录错误 logger.Error("operation failed", zap.Int("code", err.Code), zap.String("message", err.Message), zap.Time("time", err.Time), zap.String("trace", err.Trace), )
这样输出的 JSON 日志可被 ELK 或 Loki 等系统高效解析。
中间件或拦截器统一处理错误
在 Web 服务中（如使用 Gin 或 echo），可通过中间件捕获未处理的错误并写入日志。
Gin 示例：
func ErrorLogger() gin.HandlerFunc { return func(c *gin.Context) {c.Next() // 处理请求 for _, err := range c.Errors {logger.Error("request error", zap.String("path", c.Request.URL.Path), zap.String("method", c.Request.Method), zap.String("error", err.Error()), ) } } }
确保所有 API 返回格式一致：
c.JSON(500, gin.H{ "success": false, "error": err.Message, "code": err.Code,})
关键建议
- 不要忽略原始错误，使用 errors.Wrap（来自 pkg/errors）添加上下文
- 生产环境避免暴露敏感堆栈，可在日志中开启 / 关闭 trace 输出
- 为不同错误类型设置分级（如 warning、critical），配合告警系统
- 所有外部调用（DB、http）都应包装成统一错误并记录
基本上就这些。核心是 标准化错误结构 + 结构化日志输出 + 全局捕获机制，这样能大幅提升排查效率。不复杂但容易忽略。
