使用 Docker 进行 Go 集成测试：高级水平

使用 Docker 进行 Go 集成测试：从理论到高级实践

集成测试是开发 Go 微服务的关键阶段。如果不检查与数据库、消息队列和外部 API 的交互，您可能会在最糟糕的情况下遇到“在我机器上能运行”的问题。Docker 允许为每个测试创建干净、隔离的环境，而高级技术则能快速、并行且无痛地完成这些操作。在本文中，我们将分析高级工程师使用的真实方法。

1. 为什么 Docker 是 Go 集成测试的理想伙伴

Go 编译为静态二进制文件，使其成为容器化的理想候选。在进行集成测试时，Docker 解决了三个关键问题：

\n
• 隔离性：每个测试都会获得一个全新的数据库或 Redis，没有之前运行留下的“垃圾”。
\n
• 可重现性：测试在开发人员机器、CI/CD 和生产环境中的运行方式相同。
\n
• 速度：配置正确的容器可在几秒内启动，而不是几分钟。
\n

新手的主要错误是为所有测试启动一个容器。这会导致竞态条件和“飘忽不定”的错误。高级方法是：每个测试包一个容器，甚至每个单独的测试一个容器。

2. 用于 Go 的 Testcontainers：从代码管理容器

testcontainers-go 库允许直接从 Go 测试中管理 Docker 容器。这比编写 bash 脚本或依赖预启动的 Docker Compose 更优雅。

安装：

go get github.com/testcontainers/testcontainers-go\ngo get github.com/testcontainers/testcontainers-go/modules/postgres

示例：使用迁移测试 PostgreSQL：

package integration_test\n\nimport (\n    "context"\n    "database/sql"\n    "testing"\n    "time"\n\n    "github.com/testcontainers/testcontainers-go"\n    "github.com/testcontainers/testcontainers-go/modules/postgres"\n    "github.com/testcontainers/testcontainers-go/wait"\n    _ "github.com/lib/pq"\n)\n\nfunc TestUserRepository(t *testing.T) {\n    ctx := context.Background()\n\n    pgContainer, err := postgres.RunContainer(ctx,\n        testcontainers.WithImage("postgres:16-alpine"),\n        postgres.WithDatabase("testdb"),\n        postgres.WithUsername("user"),\n        postgres.WithPassword("password"),\n        testcontainers.WithWaitStrategy(\n            wait.ForLog("database system is ready to accept connections").\n                WithOccurrence(2).\n                WithStartupTimeout(30*time.Second),\n        ),\n    )\n    if err != nil {\n        t.Fatal(err)\n    }\n    defer pgContainer.Terminate(ctx)\n\n    connStr, err := pgContainer.ConnectionString(ctx, "sslmode=disable")\n    if err != nil {\n        t.Fatal(err)\n    }\n\n    db, err := sql.Open("postgres", connStr)\n    if err != nil {\n        t.Fatal(err)\n    }\n    defer db.Close()\n\n    // 在此处执行迁移和测试\n    _, err = db.Exec(`CREATE TABLE IF NOT EXISTS users (\n        id SERIAL PRIMARY KEY,\n        name TEXT NOT NULL\n    )`)\n    if err != nil {\n        t.Fatal(err)\n    }\n\n    // 测试仓库\n    repo := NewUserRepository(db)\n    user, err := repo.Create(ctx, "Alice")\n    if err != nil {\n        t.Fatal(err)\n    }\n    if user.Name != "Alice" {\n        t.Errorf("expected Alice, got %s", user.Name)\n    }\n}

关键点：

\n
• WithWaitStrategy — 等待 PostgreSQL 真正准备好，而不仅仅是容器启动。
\n
• defer pgContainer.Terminate(ctx) — 即使在 panic 时也能保证清理。
\n
• 每个测试都获得自己的数据库实例 — 完全隔离。
\n

3. 并行测试和资源管理

Go 支持并行