使用结构化日志（如zap）记录错误上下文和调用栈，通过中间件统一捕获panic，结合errors包增强错误链，关键错误触发告警，提升Go服务可观测性。
在 Go 语言开发中，良好的日志系统是保障服务可观测性和排查问题的关键。错误捕获与日志记录紧密结合，能帮助开发者快速定位异常源头。要实现有效的错误捕获，不能只依赖 fmt.Println 或简单的 log 包输出，而应构建结构化、可追溯的机制。
使用结构化日志提升可读性与可检索性
Go 标准库的 log 包功能有限，推荐使用如 zap、logrus 等支持结构化日志的第三方库。以 zap 为例：
安装 zap：
go get go.uber.org/zap
初始化 logger 并记录带字段的日志：
立即学习“go语言免费学习笔记（深入）”；
logger, _ := zap.NewProduction()
defer logger.Sync()
func divide(a, b int) (int, error) {
if b == 0 {
logger.Error("division by zero",
zap.Int("a", a),
zap.Int("b", b),
zap.Stack("stack"))
return 0, fmt.Errorf("cannot divide %d by zero", a)
}
return a / b, nil
}
这样记录的错误包含上下文字段和调用栈，便于在日志系统（如 ELK 或 Loki）中过滤分析。
统一错误处理中间件或包装函数
在 Web 服务中，可通过中间件集中捕获并记录 panic 和错误响应。例如在 Gin 框架中：
func ErrorLoggingMiddleware(logger *zap.Logger) gin.HandlerFunc {
return func(c *gin.Context) {
defer func() {
if err := recover(); err != nil {
logger.Error("panic recovered",
zap.Any("error", err),
zap.String("path", c.Request.URL.Path),
zap.Stack("stack"))
c.AbortWithStatus(http.StatusInternalServerError)
}
}()
c.Next()
}
}
// 使用
r := gin.New()
r.Use(ErrorLoggingMiddleware(zap.L()))
该中间件确保所有未处理的 panic 都会被捕获并写入日志，避免服务崩溃且无迹可寻。
结合 errors 包增强错误上下文
Go 1.13+ 支持 %w 包装错误，可保留原始错误链。配合日志使用，能更完整地还原错误路径：
if err := readFile(); err != nil {
return fmt.Errorf("failed to process config: %w", err)
}
记录时可通过 errors.Is() 和 errors.As() 判断特定错误类型，做差异化处理或告警：
if errors.Is(err, os.ErrNotExist) {
logger.Warn("config file missing", zap.Error(err))
} else {
logger.Error("unexpected error", zap.Error(err))
}
关键操作添加日志钩子与告警触发
对数据库连接失败、外部 API 调用超时等关键错误，可在日志写入后触发通知。例如：
- 将严重错误发送到 Slack 或钉钉 webhook
- 集成 Prometheus 记录错误计数器，用于监控看板
- 通过日志级别自动触发告警（如 ERROR 日志频率突增）
zap 可通过 core 自定义写入逻辑，实现日志同时输出到文件和远程告警服务。
基本上就这些。关键是把错误捕获融入日常编码习惯，用结构化日志代替零散打印，再通过统一入口管理异常路径，就能大幅提升系统的可观测性。不复杂但容易忽略。
