定义统一错误结构体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）都应包装成统一错误并记录
基本上就这些。核心是标准化错误结构 + 结构化日志输出 + 全局捕获机制，这样能大幅提升排查效率。不复杂但容易忽略。