Go / 系统课时
设计数据库集成测试
设计数据库集成测试
数据库集成测试要验证真实 SQL、约束和事务行为,同时避免测试数据互相污染。本课以 PostgreSQL 为例,用专用测试库、显式初始化、事务回滚和最终清理组成最小闭环,并通过库名保护防止误连生产数据库。
学习目标
- 为数据库集成测试划分专用数据库与数据初始化边界
- 使用事务回滚隔离单个测试产生的数据
- 设计失败也能执行的清理与安全保护机制
先隔离数据库再写断言
集成测试首先要保证“连的是测试资源”。最简单的硬约束是使用独立数据库,例如 app_test,并把连接串放在 TEST_DATABASE_URL。测试启动后再次查询当前数据库名称,名称不符合约定就立即失败,避免因为环境变量配置错误而清空真实数据。
共享同一个测试库时,初始化和清理必须可重复。示例使用 CREATE TABLE IF NOT EXISTS 建立最小表结构,并在测试前后执行 TRUNCATE。这种方式适合串行的小型测试集;如果测试会并行运行,更稳妥的做法是每个测试使用独立 schema、独立数据库或一次性容器。
用事务回滚隔离测试数据
下面的完整测试连接 PostgreSQL,确认数据库名以 _test 结尾,初始化 users 表,然后在事务中插入一行数据。事务内能够读到该行,回滚后再从普通连接查询,记录数必须回到 0。
package dbtest
import (
"context"
"database/sql"
"os"
"strings"
"testing"
_ "github.com/jackc/pgx/v5/stdlib"
)
func TestCreateUserRollbackIsolation(t *testing.T) {
dsn := os.Getenv("TEST_DATABASE_URL")
if dsn == "" {
t.Fatal("TEST_DATABASE_URL is required")
}
db, err := sql.Open("pgx", dsn)
if err != nil {
t.Fatalf("open database: %v", err)
}
t.Cleanup(func() { _ = db.Close() })
var dbName string
if err := db.QueryRow(`SELECT current_database()`).Scan(&dbName); err != nil {
t.Fatalf("read database name: %v", err)
}
if !strings.HasSuffix(dbName, "_test") {
t.Fatalf("refuse to run against non-test database %q", dbName)
}
const setup = `
CREATE TABLE IF NOT EXISTS users (
id BIGSERIAL PRIMARY KEY,
email TEXT NOT NULL UNIQUE
);
TRUNCATE TABLE users RESTART IDENTITY;if _, err := db.Exec(setup); err != nil {
t.Fatalf("prepare schema: %v", err)
}
// 先注册表清理,再注册事务回滚;Cleanup 会按后进先出执行。
t.Cleanup(func() { _, _ = db.Exec(`TRUNCATE TABLE users RESTART IDENTITY`) })
tx, err := db.BeginTx(context.Background(), nil)
if err != nil {
t.Fatalf("begin transaction: %v", err)
}
t.Cleanup(func() { _ = tx.Rollback() })
if _, err := tx.Exec(
`INSERT INTO users(email) VALUES ($1)`,
"alice@example.test",
); err != nil {
t.Fatalf("insert user: %v", err)
}
var inTx int
if err := tx.QueryRow(`SELECT count(*) FROM users`).Scan(&inTx); err != nil {
t.Fatalf("count in transaction: %v", err)
}
if inTx != 1 {
t.Fatalf("count in transaction = %d, want 1", inTx)
}
if err := tx.Rollback(); err != nil {
t.Fatalf("rollback: %v", err)
}
var persisted int
if err := db.QueryRow(`SELECT count(*) FROM users`).Scan(&persisted); err != nil {
t.Fatalf("count after rollback: %v", err)
}
if persisted != 0 {
t.Fatalf("persisted rows = %d, want 0", persisted)
}}
预期结果
`text
测试通过;事务内 users 记录数为 1,回滚后测试库中的 users 记录数为 0。示例依赖 pgx 的 database/sql 适配器,并要求 TEST_DATABASE_URL 指向名称以 _test 结尾的 PostgreSQL 数据库。准备好测试库后可在 Go 模块中执行:
go get github.com/jackc/pgx/v5/stdlib
TEST_DATABASE_URL='postgres://<USER>:<PASSWORD>@<HOST>:<PORT>/app_test?sslmode=disable' go test -run TestCreateUserRollbackIsolation -v .预期输出
=== RUN TestCreateUserRollbackIsolation
--- PASS: TestCreateUserRollbackIsolation (<TIME>)
PASS
ok <PATH> <TIME><HOST>、<PORT>、<PATH> 和 <TIME> 需替换或对应实际环境;用户名与密码也应来自测试环境,不要写入仓库。
把初始化、隔离和清理分成三层
初始化负责把数据库带到已知结构和基线数据;单个测试负责制造自己的变化;清理负责让下一次执行重新回到基线。将三者混在一个共享脚本中,通常会让失败后的现场难以判断,也容易出现测试顺序依赖。
事务回滚适合验证插入、更新、删除和约束失败,但它不能覆盖“提交后才发生”的行为,例如提交触发的异步任务或某些事务外观察。如果测试目标本身就是提交语义,应改用独立 schema、唯一业务键或测试容器,并在 t.Cleanup 中删除对应资源。
验证测试真的可重复
数据库集成测试至少要连续运行两次都通过,最好再执行随机顺序或整包测试,检查是否存在残留数据和顺序依赖。共享表的测试不要轻易调用 t.Parallel;一旦需要并行,应把隔离单位从“事务”提升到“独立 schema 或独立数据库”。
最可靠的验收标准不是“第一次跑通”,而是测试在失败、中断和重复执行后仍能回到可预测状态。专用测试库、防误连保护、确定性初始化和自动清理共同组成了这个边界。