17370845950

Go集成测试需用真实依赖（如SQLite、Redis）并可控重置状态，通过子测试隔离场景，注重日志与显式断言，支持CI环境且用-tags控制运行。

在 Go 中做集成测试，核心是让多个模块（比如 HTTP handler、数据库访问层、外部服务客户端）在接近真实环境的条件下协作运行，验证它们之间的交互逻辑是否正确。重点不是单个函数的内部逻辑（那是单元测试的事），而是“组合起来能不能跑通”。

用真实依赖代替 mock，但要可控

集成测试应尽量使用真实的依赖组件，比如真正的 SQLite 文件、本地启动的 Redis 实例、或轻量 HTTP 服务，但必须确保每次测试前可重置状态。例如：

• 数据库测试前清空表或使用临时数据库文件（sqlite://file:test.db?mode=memory&cache=shared）
• HTTP 服务依赖可用 httptest.NewUnstartedServer 启动真实 handler，再手动控制启停
• 避免硬编码端口，用 port := freeport.Get()（配合 github.com/mafredri/cdp 或简单 net.Listen 获取空闲端口）

组织测试代码：用子测试 + setup 函数隔离场景

一个集成测试文件通常对应一个业务流程（如“用户注册并触发邮件通知”），用 t.Run 拆分子场景，每个子测试有独立 setup 和 teardown：

• setup 阶段初始化 DB 连接、启动 mock 外部服务（如用 gock 拦截 HTTP 请求并返回预设响应）、插入测试数据
• teardown 阶段关闭连接、清理临时文件、重置 gock 拦截器
• 避免测试间共享状态，不依赖执行顺序

关注可观测性：日志 + 显式断言

集成测试失败时很难定位问题，所以要在关键路径加调试日志（用 t.Log），并在每一步后做明确断言：

• 检查数据库写入是否成功（查表确认记录存在、字段值正确）
• 验证 HTTP 响应状态码、JSON body 字段、Header
• 确认异步任务（如发邮件）是否被调用——可改用内存队列或注入回调钩子捕获行为

运行与 CI 友好：用标志控制资源启动

本地开发时可自动拉起依赖，CI 环境则需适配（如 GitHub Actions 提前启动 PostgreSQL 容器）。推荐用 -short 跳过耗时集成测试，或自定义 flag：

go test -tags=integration ./...

并在测试文件开头加 //go:build integration，配合 go test -tags=integration 精确运行。