- 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;七把尺子全绿
116 lines
4.4 KiB
Rust
116 lines
4.4 KiB
Rust
//! 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 行"
|
||
);
|
||
}
|