Golang日志收集与错误处理项目示例-Golang-PHP中文网

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

P粉602998670

发布： 2025-10-07 14:46:02

原创

1034人浏览过

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

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

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

使用Zap记录结构化日志

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

安装zap：

go get go.uber.org/zap

基础日志初始化与使用：

立即学习“go语言免费学习笔记（深入）”；

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

登录后复制

}