Golang错误日志记录与调试技巧

正确记录错误和调试是Go程序稳定的关键。使用标准库log记录带时间戳的错误，结合errors包增强上下文，生产环境推荐zap等结构化日志库，并辅以Delve调试和pprof性能分析，小项目用标准库，大项目需完整工具链，日志应包含上下文但不泄露敏感信息。

在Go语言开发中，正确记录错误信息和使用调试方法是保证程序稳定性和可维护性的关键。良好的日志习惯能帮助开发者快速定位问题，而合适的调试手段则提升排查效率。

使用标准库 log 记录错误

Go的log包是记录错误的基础工具，适合简单场景。

说明： 通过log.Printf或log.Println输出带时间戳的错误信息，便于追踪发生时间。

• 使用log.SetOutput将日志写入文件而非默认的stderr
• 配合log.SetFlags(log.LstdFlags | log.Lshortfile)添加文件名和行号
• 遇到错误时，直接打印err.Error()或用%v格式化输出

示例：
if err != nil {
  log.Printf("failed to open file: %v", err)
}

结合 errors 包增强错误上下文

原生error类型信息有限，可通过包装增加上下文。

建议： 使用fmt.Errorf配合%w动词保留原始错误链。

• 在函数返回前添加上下文，如“读取配置失败”
• 使用errors.Is和errors.As判断错误类型
• 避免丢失底层错误，利于后续分析

例如：
if err != nil {
  return fmt.Errorf("process data failed: %w", err)
}

使用第三方日志库（如 zap 或 logrus）

生产环境中推荐结构化日志库，便于检索与监控。

zap由Uber开源，性能高，支持结构化字段。

• 使用zap.NewProduction()获取生产级logger
• 记录错误时传入zap.Error(err)自动展开
• 添加自定义字段如请求ID、用户ID等辅助排查

示例：
logger.Error("db query failed",
  zap.String("query", sql),
  zap.Error(err))

常用调试方法

除日志外，调试手段能更快发现问题根源。

• 使用println或fmt.Println临时输出变量值（上线前应移除）
• 借助Delve（dlv）进行断点调试，支持远程调试
• 利用pprof分析CPU、内存使用情况，发现潜在性能瓶颈
• 在HTTP服务中加入中间件记录请求/响应体和耗时

启动Delve：
dlv debug main.go

基本上就这些。关键是根据项目规模选择合适方案：小项目可用标准库+简单打印，大项目建议上结构化日志和调试工具链。日志要包含足够上下文，但避免泄露敏感信息。调试时尽量模拟真实环境。不复杂但容易忽略。