Rust / 系统课时
用测试数据库验证真实交互
用测试数据库验证真实交互
这篇课时解决“代码在 mock 数据库上通过,但接入真实数据库后才暴露问题”的测试缺口。通过独立测试数据库执行真实 SQL、事务和约束,让集成测试验证应用与数据库之间真正的交互行为。
学习目标
- 能为集成测试准备独立、可重复使用的测试数据库
- 能验证查询、事务提交与回滚、唯一约束等真实数据库行为
- 能区分单元测试、数据库集成测试与生产数据库,避免测试污染真实数据
为什么要用真实数据库
mock 可以快速验证调用次数和返回值,却无法可靠模拟数据库真正执行 SQL 时的行为。字段类型转换、NULL、唯一约束、事务隔离以及数据库特有函数,都可能在 mock 环境中被掩盖。
数据库集成测试的目标不是把所有测试都变慢,而是在少量关键用例中,让 SQL 真正进入测试数据库。通常把这类测试集中在 repository、DAO 或跨事务的应用服务边界。
准备隔离的测试数据库
测试数据库必须与开发库、生产库隔离。最常见做法是通过环境变量指定测试连接串,并在测试开始前运行迁移;测试结束后清理数据或直接销毁临时数据库。
下面示例使用 Rust 的 sqlx,把测试连接串放在环境变量 TEST_DATABASE_URL 中。代码演示测试核心逻辑,实际项目还需要按所用数据库执行迁移。
use sqlx::{postgres::PgPoolOptions, Row};
#[tokio::test]
async fn creates_user_and_reads_real_row() -> Result<(), sqlx::Error> {
let database_url = std::env::var("TEST_DATABASE_URL")
.expect("TEST_DATABASE_URL must be set");
let pool = PgPoolOptions::new()
.max_connections(5)
.connect(&database_url)
.await?;
sqlx::query("DELETE FROM users WHERE email = $1")
.bind("alice@example.com")
.execute(&pool)
.await?;
sqlx::query("INSERT INTO users (email, name) VALUES ($1, $2)")
.bind("alice@example.com")
.bind("Alice")
.execute(&pool)
.await?;
let row = sqlx::query("SELECT email, name FROM users WHERE email = $1")
.bind("alice@example.com")
.fetch_one(&pool)
.await?;
assert_eq!(row.get::<String, _>("email"), "alice@example.com");
assert_eq!(row.get::<String, _>("name"), "Alice");
Ok(())
}预期结果
running 1 test
test creates_user_and_reads_real_row ... ok这个测试真正验证了连接、INSERT、SELECT 以及数据库字段映射。TEST_DATABASE_URL 的实际值取决于本地或 CI 环境,不能直接填写生产数据库地址。
验证事务与约束
真实数据库测试的价值还在于验证“数据库必须保证”的规则。例如创建用户时要求邮箱唯一,那么测试应该让数据库产生真实约束错误,而不是由 mock 手工返回一个错误对象。
事务测试则关注提交和回滚后的最终状态。一个典型场景是订单创建和库存扣减必须在同一事务中完成:任一步失败,都不应留下部分写入。
测试时要特别注意清理策略。一个测试失败后留下的数据可能导致下一个测试因为唯一约束而失败,形成难以定位的串行依赖。可以使用事务回滚、独立 schema,或每个测试创建独立数据库等方式隔离状态。
什么时候值得使用
适合放入数据库集成测试的内容,包括复杂 SQL、数据库约束、事务边界、数据库特有类型以及 repository 与真实数据库的映射。简单的业务分支仍可优先用单元测试覆盖,否则整个测试套件会因为数据库启动和 I/O 变慢。
实践时可以形成两层结构:快速单元测试负责大量业务规则,少量数据库集成测试负责证明“这些 SQL 在目标数据库上真的成立”。这样既保留反馈速度,也覆盖 mock 无法证明的真实行为。