3. Go 项目初始化与环境搭建：Go Module 初始化、安装 OpenTelemetry SDK 及相关依赖包

在开始链路追踪与慢查询分析之前，必须先搭建一个标准、可复现的 Go 项目环境。本章将指导你完成从 Go Module 初始化到 OpenTelemetry SDK 及关键依赖包安装 的全过程，确保后续所有实验代码在统一的依赖管理下运行。

3.1 Go Module 初始化

Go Module 是 Go 1.11+ 引入的官方依赖管理机制，它通过 go.mod 文件锁定项目依赖的精确版本。请按以下步骤操作：

1. 创建项目目录：mkdir go-slow-query-otel && cd go-slow-query-otel
2. 初始化 Module：go mod init github.com/your-org/go-slow-query-otel
3. 验证生成文件：检查目录下是否出现 go.mod 文件

3.2 安装 OpenTelemetry SDK 核心包

OpenTelemetry 在 Go 生态中由多个子包组成。下表列出了本次课程必须安装的核心依赖及其用途：

3.3 安装数据库与中间件相关依赖

为了模拟慢查询场景，我们需要集成数据库驱动和 HTTP 框架。以下是推荐安装的附加包：

• 数据库驱动：go get github.com/go-sql-driver/mysql（MySQL）或 go get github.com/lib/pq（PostgreSQL）
• 数据库连接池：go get database/sql（标准库，无需额外安装）
• HTTP 路由：go get github.com/gorilla/mux 或 go get github.com/gin-gonic/gin
• OpenTelemetry 数据库 instrumentation：go get go.opentelemetry.io/contrib/instrumentation/database/sql
• OpenTelemetry HTTP instrumentation：go get go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp

3.4 依赖安装后的项目结构

执行完上述 go get 命令后，项目目录应包含以下关键文件：

go-slow-query-otel/
├── go.mod          # 模块定义与依赖版本锁定
├── go.sum          # 依赖哈希校验文件（自动生成）
├── main.go         # 后续实验入口文件
├── internal/       # 内部业务逻辑包
│   ├── db/         # 数据库操作层
│   └── handler/    # HTTP 请求处理器
└── config/         # 配置文件目录
    └── config.go   # 配置加载逻辑

3.5 依赖关系与数据流架构

下图展示了初始化完成后，各依赖包之间的调用关系与数据流向：

3.6 验证安装是否成功

在 main.go 中写入以下最小验证代码，然后执行 go run main.go：

package main

import (
    "fmt"
    "go.opentelemetry.io/otel"
    "go.opentelemetry.io/otel/attribute"
    "go.opentelemetry.io/otel/exporters/otlp/otlptrace"
    "go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc"
    "go.opentelemetry.io/otel/sdk/resource"
    sdktrace "go.opentelemetry.io/otel/sdk/trace"
    semconv "go.opentelemetry.io/otel/semconv/v1.17.0"
)

func main() {
    // 1. 创建 OTLP 导出器（使用 gRPC）
    exporter, err := otlptrace.New(
        context.Background(),
        otlptracegrpc.NewClient(
            otlptracegrpc.WithEndpoint("localhost:4317"),
            otlptracegrpc.WithInsecure(),
        ),
    )
    if err != nil {
        panic(fmt.Sprintf("创建 OTLP 导出器失败: %v", err))
    }

    // 2. 创建资源（标识服务名称）
    res, err := resource.New(
        context.Background(),
        resource.WithAttributes(
            semconv.ServiceNameKey.String("slow-query-demo"),
        ),
    )
    if err != nil {
        panic(fmt.Sprintf("创建资源失败: %v", err))
    }

    // 3. 创建 TracerProvider
    tp := sdktrace.NewTracerProvider(
        sdktrace.WithBatcher(exporter),
        sdktrace.WithResource(res),
    )
    otel.SetTracerProvider(tp)

    fmt.Println("✅ OpenTelemetry SDK 初始化成功，依赖安装验证通过！")
}

3.7 常见问题与避坑指南

完成以上步骤后，你的 Go 项目已经具备了完整的 OpenTelemetry 链路追踪能力。下一阶段将进入实际代码编写，利用这些依赖包对数据库慢查询进行自动埋点与追踪。