Files
tdc-rs/tests/sspf_db_lock.rs
admin e13768edd5 feat(p5): 业务库操作改走 sspf Db,与平台共用同一把锁
- Cargo.toml 升到 sspf v0.5.0;platform/db.rs 注入进程级 Arc<Db>
- query_json_params→query_json_raw(不归一)/ exec_params / query_scalar_text+column_types→query_rows
- 函数签名仍 db: &PGlite,service/* 与 controller/* 零改动;ensure_schema 启动期豁免
- main.rs 在任何业务 DB 操作前注入,失败即退出(不接受静默双锁)
- 新增 tests/sspf_db_lock.rs:真库验不归一 + 平台持锁时业务写排队
- 双契约尺子 17→18 断言(启动日志自证锁已接入)
- sspf_platform_package 的版本断言改为从 Cargo.toml 读 tag 对账,升级不再手改
- cargo test 296 passed / 0 failed / 1 ignored;七把尺子全绿
2026-11-04 23:08:08 +08:00

116 lines
4.4 KiB
Rust
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! P5 探针:业务库操作**真的**持平台的 `Db.lock`(而不是 tdc 自己那把 `db_lock`)。
//!
//! 判据(对应 `ssw-platform/docs/SSPF-BUSINESS-DB-ACCESS.md` §4 的业务侧验收):
//! 1. `platform::db::*` 切换后仍**不归一** —— `f_*` 键原样出来(归一由业务 `mapper` 做);
//! 2. 平台持 `Db.lock` 期间,业务写**排队**而不是插队 ⇒ 单进程单锁成立。
//!
//! 🔴 这两条必须真进程验:静态护栏只能说「调用点收在一处」,说不了「锁是不是同一把」。
//! 🔴 `pglite-rs` 每进程只允许一个实例 ⇒ 本文件用 `OnceCell` 共享**一个** `Db`
//! (两个测试并行跑也只有一个库)。
use std::sync::Arc;
use std::time::Duration;
use sspf::Db;
use tdc_connector::platform::db;
/// 进程级唯一的平台库(`OnceCell` 保证并发测试只开一次)。
static DB: tokio::sync::OnceCell<Arc<Db>> = tokio::sync::OnceCell::const_new();
async fn shared_db() -> Arc<Db> {
DB.get_or_init(|| async {
let db = Arc::new(Db::open_temp().await.expect("打开临时库失败"));
assert!(
db::install_sspf_db(db.clone()),
"进程级注入只允许一次(pglite 每进程只有一个实例)"
);
db
})
.await
.clone()
}
/// ① 四个查询入口全部经平台 `Db`,且 **JSON 键不归一**。
#[tokio::test]
async fn business_sql_holds_the_platform_lock_and_leaves_keys_raw() {
let db = shared_db().await;
let pg = db.pg();
db.exec("DROP TABLE IF EXISTS p5_probe").await.unwrap();
db.exec("CREATE TABLE p5_probe (f_id text, f_name text)")
.await
.unwrap();
// 写路径:`platform::db::exec_params` → `Db::exec_params`
db::exec_params(
&pg,
"INSERT INTO p5_probe VALUES ($1, $2)",
&[&"a1", &"n1"],
)
.await
.expect("业务写失败");
// 读路径:`platform::db::query_json_params` → `Db::query_json_raw`
let rows = db::query_json_params(&pg, "SELECT f_id, f_name FROM p5_probe", &[])
.await
.expect("业务读失败");
assert_eq!(rows.len(), 1);
// 🔴 契约核心:键必须是 `f_*` 原样。若这里变成 `id` / `name`,说明走了平台的
// `query_json*`(归一)而不是 `query_json_raw` ⇒ 132 条端点响应形状全漂。
assert_eq!(rows[0]["f_id"], "a1", "raw 不得归一:{rows:?}");
assert_eq!(rows[0]["f_name"], "n1", "raw 不得归一:{rows:?}");
assert!(
rows[0].get("id").is_none(),
"raw 不得把 `f_id` 折叠成 `id`:{rows:?}"
);
// 取首行首列:`query_rows`
let count = db::query_scalar_text(&pg, "SELECT count(*)::text FROM p5_probe", &[])
.await
.expect("取标量失败");
assert_eq!(count.as_deref(), Some("1"));
// 元数据:`query_rows`(`pg_catalog`)
let types = db::column_types(&pg, "p5_probe").await.expect("取列类型失败");
assert_eq!(types.get("f_id").map(String::as_str), Some("text"));
assert_eq!(types.get("f_name").map(String::as_str), Some("text"));
}
/// ② 平台持锁时业务写必须排队 —— 证明两侧用的是**同一把**锁。
#[tokio::test]
async fn business_write_queues_behind_the_platform_lock() {
let db = shared_db().await;
let pg = db.pg();
db.exec("DROP TABLE IF EXISTS p5_lock").await.unwrap();
db.exec("CREATE TABLE p5_lock (f_id text)").await.unwrap();
// 平台侧持锁(模拟平台正在跑一段业务 / 一次事务)
let guard = db.lock_owned().await;
let blocked = tokio::time::timeout(
Duration::from_millis(300),
db::exec_params(&pg, "INSERT INTO p5_lock VALUES ($1)", &[&"blocked"]),
)
.await;
assert!(
blocked.is_err(),
"平台持有 Db.lock 期间,业务写必须排队 —— 300ms 内就写成功说明用的是两把锁"
);
drop(guard);
// 解锁后立刻可写 ⇒ 不是「永久卡死」,是「排队」
db::exec_params(&pg, "INSERT INTO p5_lock VALUES ($1)", &[&"after"])
.await
.expect("解锁后业务写失败");
let count = db::query_scalar_text(&pg, "SELECT count(*)::text FROM p5_lock", &[])
.await
.expect("取标量失败");
assert_eq!(
count.as_deref(),
Some("1"),
"被超时取消的那次写不应落库 ⇒ 只应有解锁后那 1 行"
);
}