答案：Go中应封装统一的日志与错误处理，使用zap等结构化日志库，结合上下文信息如trace_id、用户标识等增强可追溯性，分级别记录日志，避免重复记录和敏感信息泄露，通过fmt.Errorf使用%w保留错误链，实现可观测性强的健壮系统。
在Go语言开发中，日志记录与错误处理是保障程序健壮性和可维护性的关键环节。良好的错误处理能让程序更稳定，而合理的日志记录则有助于问题排查和系统监控。将二者有效结合，不仅能提升代码质量，还能大幅降低线上问题的定位成本。
统一错误处理与日志记录入口
为了避免日志散落在各处、错误信息不一致，建议封装统一的错误处理和日志记录逻辑。可以使用结构化日志库如 zap 或 logrus，配合自定义错误包装函数。
例如，定义一个辅助函数，在记录错误日志的同时返回可追踪的错误：
func logError(logger *zap.Logger, msg string, err error, fields ...zap.Field) error {
logger.Error(msg, append(fields, zap.Error(err))...)
return fmt.Errorf("%s: %w", msg, err)
}
在实际调用中：
立即学习“go语言免费学习笔记（深入）”；
if err != nil {
return logError(logger, "failed to read config", err, zap.String("file", filename))
}
这样既保留了原始错误栈（使用 %w），又附加了上下文信息，便于追踪。
分层级记录日志信息
不同环境对日志的详细程度要求不同。开发环境可记录 Debug 级别，生产环境则以 Info 和 Error 为主。结合错误类型决定日志级别：
- 预期错误（如用户输入非法）可记录为 Info 或 Warn，避免日志泛滥
- 系统错误（如数据库连接失败）必须记录为 Error，并触发告警
- 关键操作（如支付、登录）即使成功也应记录 Info 日志
使用 zap 的 SugaredLogger 可简化不同级别的输出：
logger.Info("user login success", zap.String("uid", uid))
logger.Warn("invalid token format", zap.String("token", token))
logger.Error("db query failed", zap.Error(err), zap.String("sql", sql))
上下文信息增强可追溯性
单纯记录错误不够，需附加上下文才能快速定位问题。常见上下文包括：
- 请求ID：通过中间件生成唯一 trace_id，贯穿整个调用链
- 用户标识：uid、IP地址等
- 操作类型：API 路径、方法名
- 时间戳：便于与其他服务日志对齐
在 Gin 等 Web 框架中，可使用中间件注入上下文：
func LoggingMiddleware(logger *zap.Logger) gin.HandlerFunc {
return func(c *gin.Context) {
traceID := generateTraceID()
ctx := context.WithValue(c.Request.Context(), "trace_id", traceID)
c.Request = c.Request.WithContext(ctx)
logger.Info("request started",
zap.String("trace_id", traceID),
zap.String("method", c.Request.Method),
zap.String("path", c.Request.URL.Path))
c.Next()
}
}
后续处理中可通过 c.Request.Context() 获取 trace_id，并写入错误日志。
避免常见陷阱
实践中需注意以下几点：
- 不要重复记录同一错误：捕获后处理并记录一次即可，避免层层打印造成日志爆炸
- 敏感信息脱敏：如密码、token 等字段需过滤或打码
- 错误包装优先使用 fmt.Errorf(...%w) 而非字符串拼接，保留错误链
- 日志输出格式建议采用 JSON，便于日志系统采集和分析
基本上就这些。通过统一入口、分级记录、上下文增强和规避常见问题，Go 项目中的日志与错误处理能形成有效闭环，显著提升系统的可观测性。不复杂但容易忽略。
