首页 > Golang > Go教程

Golang日志与错误处理实战教程

时间：2025-10-08 23:21:37 358浏览收藏

本文深入探讨了Golang项目中如何构建高效的日志与错误处理机制，提升系统的稳定性和可维护性。通过实战示例，详细讲解了如何利用Uber的Zap库实现结构化日志输出，方便在生产环境中进行分析和调试。文章还介绍了如何定义自定义错误类型，并结合上下文追踪，更清晰地表达错误语义，便于日志追踪和问题定位。此外，还探讨了集成Grafana Loki进行集中式日志收集的可选方案，以及使用Filebeat的配置示例，从而实现日志的统一管理和告警。文章最后总结了错误处理的最佳实践，强调了日志记录的重要性，以及如何在关键路径上添加日志并携带上下文信息，帮助开发者构建一个健壮的日志与错误处理体系。

使用Zap实现结构化日志、自定义错误与上下文追踪，结合Loki进行集中式日志收集，提升Go项目稳定性与可维护性。

Golang日志收集与错误处理项目示例

在Golang项目中，良好的日志记录和错误处理机制是保障系统稳定性和可维护性的关键。一个典型的日志收集与错误处理方案应包含结构化日志输出、上下文追踪、错误分级、以及集中式日志收集能力。以下是一个实用的示例项目结构和实现方式。

使用Zap记录结构化日志

uber-go/zap 是Go语言中高性能的日志库，支持结构化日志输出，适合生产环境。

安装zap：

go get go.uber.org/zap

基础日志初始化与使用：

package main

import ( "os" "go.uber.org/zap" )

var logger *zap.Logger

func init() { var err error env := os.Getenv("ENV") if env == "prod" { logger, err = zap.NewProduction() } else { logger, err = zap.NewDevelopment() } if err != nil { panic(err) } defer logger.Sync() }

func main() { logger.Info("服务启动", zap.String("host", "localhost"), zap.Int("port", 8080), )

// 模拟错误
if err := divide(10, 0); err != nil {
    logger.Error("计算失败", zap.Error(err))
}

}

func divide(a, b int) error { if b == 0 { return &CustomError{ Code: "DIVIDE_BY_ZERO", Message: "除数不能为零", } } return nil }

自定义错误类型与上下文传递

通过定义统一的错误类型，可以更清晰地表达错误语义，并携带额外信息用于日志分析。

type CustomError struct { Code string `json:"code"` Message string `json:"message"` }

func (e *CustomError) Error() string { return e.Message }

在调用链中传递上下文并附加请求ID，便于日志追踪：

import ( "context" "github.com/google/uuid" )

func withRequestID(ctx context.Context) context.Context { return context.WithValue(ctx, "request_id", uuid.New().String()) }

func handleRequest() { ctx := withRequestID(context.Background()) requestID := ctx.Value("request_id").(string)

logger.Info("处理请求开始", zap.String("request_id", requestID))

if err := processBusiness(ctx); err != nil {
    logger.Error("业务处理失败",
        zap.String("request_id", requestID),
        zap.Error(err),
    )
}

}