ISSUE-0094:批量删除确认数量与实际删除数量存在 TOCTOU¶
用户感知的现象¶
用户在本地商家列表选择“全部”,确认框显示并要求输入一个确切数量;但确认框停留期间后台采集仍会写入数据库,新增且匹配当前筛选条件的行会被旧实现一并删除。
例如确认时显示 53 条,用户输入 53 后确认;期间新增 2 条匹配行,旧实现会按 where 删除 55 条,界面没有告知数量已经变化。
根因¶
src/api/search.ts 的 resolveTargetRows() 在 selectOption === 'all' 且没有 taskId、hasEmailOnly、keyword 客户端过滤时返回动态 jsstoreQuery。apiLocalDataDelete() 随后把该 where 直接交给 deleteByQuery(),使删除目标在执行时再次求值,而不是确认时的固定对象集。
单独在删除前 countByQuery() 不能修复:计数和删除是两个异步操作,后台仍可在两者之间写入。
修复方案¶
- 调用方把确认框显示的
selectTotal显式作为confirmedTotal传给删除 API。 all的无客户端过滤路径先按 where 查询匹配行并固化 ID。- 所有
all路径的固化 ID 数量与confirmedTotal一致时,仅执行deleteByQuery({ id: { in: ids } })。 - 数量不一致时在删除前抛出“筛选结果已变化,请重新确认”,现有 toast error 分支向用户展示。
front、current和导出路径保持原行为。
开销与边界¶
当前安装版 jsstore 的 ISelectQuery 没有列投影能力,因此固化 ID 时需要读取匹配行再映射主键,峰值内存与匹配行数线性增长。该成本换取确认数量与删除对象集的一致性;后续若要优化 10 万级以上范围,应评估原生 IndexedDB 事务游标或数据访问层新增只读主键能力,不能退回 count 后按 where 删除。
本修复担保的是确认数量与提交时固化的 ID 数量一致,并保证 ID 固化后的新写入不被纳入。如果确认后、固化前恰好发生等基数成员替换(一条离开筛选集、另一条进入),单凭数量无法证明集合身份未变;要担保身份必须在确认框建立时同时保存完整 ID 集或稳定版本。
改动文件¶
| 文件 | 改动 |
|---|---|
src/api/search.ts |
all 删除先固化 ID、校验确认数量、再按 ID 删除 |
src/utils/jsstore/search-data.ts |
增加按 where 查询并映射 ID 的 helper |
src/sections/page/local-data-view.tsx |
下传确认框显示的数量 |
tests/api-local-data-delete-toctou.test.ts |
覆盖数量一致删除与数量不一致拒删 |
vitest.config.ts |
配置 @ 源码别名,使 API 模块可被 Vitest 直接加载 |
验证方式¶
- 数量一致:查询得到 2 个 ID,断言删除只收到
{ id: { in: [101, 102] } }。 - 数量不一致:确认 2 条、查询得到 3 个 ID,断言抛出明确错误且删除函数调用次数为 0。
- 客户端过滤的
all路径同样在 2 对 3 时拒绝删除。 - 运行
pnpm test与pnpm verify。
如何避免再犯¶
- 确认框担保对象数量的破坏性操作,执行目标必须先固化,不能在最终写操作时重新按动态条件求值。
- count 与后续写操作之间没有事务隔离时,count 只能用于提示,不能作为 TOCTOU 防线。
- 用户确认快照值应使用独立参数名传入 API,并在任何写操作前校验。