Go集成测试验证多组件协同，需连接真实外部系统，运行较慢但能暴露配置、网络等问题；应通过构建标签（如//go:build integration）控制执行，用t.Cleanup清理资源，并可用testcontainers-go启动Docker数据库确保环境一致。
在Go语言开发中，集成测试用于验证多个组件协同工作时的正确性，比如数据库操作、外部API调用或服务间通信。与单元测试只关注单一函数不同，集成测试更贴近真实运行环境，能有效发现系统级问题。
理解集成测试与单元测试的区别
单元测试通常隔离依赖，使用mock或stub模拟外部行为，而集成测试会连接真实的外部系统。这意味着集成测试运行较慢，但能暴露配置错误、网络问题或数据序列化异常等单元测试难以捕捉的问题。
- 单元测试：快速、独立、无外部依赖
- 集成测试：较慢、依赖真实环境、验证系统整体行为
组织集成测试代码结构
Go推荐将测试文件放在对应包目录下，集成测试可单独命名以区分，例如user_integration_test.go。一种常见做法是通过构建标签控制是否执行集成测试。
在测试文件顶部添加构建标签：
立即学习“go语言免费学习笔记（深入）”；
//go:build integration这样可以通过go test -tags=integration有选择地运行集成测试，避免每次执行都触发耗时操作。
编写数据库集成测试示例
假设有一个用户存储模块需要与PostgreSQL交互。集成测试应启动真实数据库连接并执行CRUD操作。
示例代码：
db, err := sql.Open("pgx", "host=localhost port=5432 dbname=testdb user=test password=test")
if err != nil {
t.Fatal(err)
}
defer db.Close()
err = db.Ping()
if err != nil {
t.Skip("database not available")
}
store := &UserStore{DB: db}
err = store.CreateUser("alice", "alice@example.com")
if err != nil {
t.Fatalf("failed to create user: %v", err)
}
user, err := store.GetUserByEmail("alice@example.com")
if err != nil {
t.Fatalf("failed to get user: %v", err)
}
if user.Name != "alice" {
t.Errorf("expected name alice, got %s", user.Name)
} }
该测试连接数据库、创建用户并查询验证，覆盖了实际SQL执行和数据映射逻辑。
使用临时资源与清理机制
集成测试应确保环境干净，避免前后测试相互影响。建议在测试开始前准备数据，在结束后清理。
- 使用事务包裹操作，测试结束回滚
- 每次测试使用唯一表名或schema
- 在t.Cleanup()中注册删除语句
例如：
t.Cleanup(func() {store.DeleteUser("alice@example.com")
})
结合Docker启动依赖服务
为保证测试可重复性，可在CI环境中用Docker启动数据库。工具如testcontainers-go支持在测试中动态创建容器。
简要流程：
这使得本地和CI环境保持一致，无需预装数据库。
基本上就这些。写好集成测试的关键是控制范围、管理资源、保证独立性和可重复性。合理使用标签、清理函数和容器化依赖，能让Go项目的集成测试稳定又实用。
