Golang如何在日志系统中捕获错误_Golang 日志系统错误捕获实践_技术教程

使用结构化日志（如zap）记录错误上下文和调用栈，通过中间件统一捕获panic，结合errors包增强错误链，关键错误触发告警，提升Go服务可观测性。

在 Go 语言开发中，良好的日志系统是保障服务可观测性和排查问题的关键。错误捕获与日志记录紧密结合，能帮助开发者快速定位异常源头。要实现有效的错误捕获，不能只依赖 fmt.Println 或简单的 log 包输出，而应构建结构化、可追溯的机制。

使用结构化日志提升可读性与可检索性

Go 标准库的 log 包功能有限，推荐使用如 zap、logrus 等支持结构化日志的第三方库。以 zap 为例：

示例代码：

安装 zap：

go get go.uber.org/zap

初始化 logger 并记录带字段的日志：

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))
}