Go / 系统课时

设计数据库集成测试

设计数据库集成测试

数据库集成测试要验证真实 SQL、约束和事务行为,同时避免测试数据互相污染。本课以 PostgreSQL 为例,用专用测试库、显式初始化、事务回滚和最终清理组成最小闭环,并通过库名保护防止误连生产数据库。

学习目标

  • 为数据库集成测试划分专用数据库与数据初始化边界
  • 使用事务回滚隔离单个测试产生的数据
  • 设计失败也能执行的清理与安全保护机制

先隔离数据库再写断言

集成测试首先要保证“连的是测试资源”。最简单的硬约束是使用独立数据库,例如 app_test,并把连接串放在 TEST_DATABASE_URL。测试启动后再次查询当前数据库名称,名称不符合约定就立即失败,避免因为环境变量配置错误而清空真实数据。

共享同一个测试库时,初始化和清理必须可重复。示例使用 CREATE TABLE IF NOT EXISTS 建立最小表结构,并在测试前后执行 TRUNCATE。这种方式适合串行的小型测试集;如果测试会并行运行,更稳妥的做法是每个测试使用独立 schema、独立数据库或一次性容器。

用事务回滚隔离测试数据

下面的完整测试连接 PostgreSQL,确认数据库名以 _test 结尾,初始化 users 表,然后在事务中插入一行数据。事务内能够读到该行,回滚后再从普通连接查询,记录数必须回到 0。

go
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;
CODE
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)
}

}

CODE

预期结果

`text
测试通过;事务内 users 记录数为 1,回滚后测试库中的 users 记录数为 0。

示例依赖 pgx 的 database/sql 适配器,并要求 TEST_DATABASE_URL 指向名称以 _test 结尾的 PostgreSQL 数据库。准备好测试库后可在 Go 模块中执行:

bash
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 .

预期输出

text
=== RUN   TestCreateUserRollbackIsolation
--- PASS: TestCreateUserRollbackIsolation (<TIME>)
PASS
ok      <PATH>  <TIME>

<HOST>、<PORT>、<PATH> 和 <TIME> 需替换或对应实际环境;用户名与密码也应来自测试环境,不要写入仓库。

把初始化、隔离和清理分成三层

初始化负责把数据库带到已知结构和基线数据;单个测试负责制造自己的变化;清理负责让下一次执行重新回到基线。将三者混在一个共享脚本中,通常会让失败后的现场难以判断,也容易出现测试顺序依赖。

事务回滚适合验证插入、更新、删除和约束失败,但它不能覆盖“提交后才发生”的行为,例如提交触发的异步任务或某些事务外观察。如果测试目标本身就是提交语义,应改用独立 schema、唯一业务键或测试容器,并在 t.Cleanup 中删除对应资源。

验证测试真的可重复

数据库集成测试至少要连续运行两次都通过,最好再执行随机顺序或整包测试,检查是否存在残留数据和顺序依赖。共享表的测试不要轻易调用 t.Parallel;一旦需要并行,应把隔离单位从“事务”提升到“独立 schema 或独立数据库”。

最可靠的验收标准不是“第一次跑通”,而是测试在失败、中断和重复执行后仍能回到可预测状态。专用测试库、防误连保护、确定性初始化和自动清理共同组成了这个边界。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

设计数据库集成测试

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通