跳转至

ISSUE-0094:批量删除确认数量与实际删除数量存在 TOCTOU

用户感知的现象

用户在本地商家列表选择“全部”,确认框显示并要求输入一个确切数量;但确认框停留期间后台采集仍会写入数据库,新增且匹配当前筛选条件的行会被旧实现一并删除。

例如确认时显示 53 条,用户输入 53 后确认;期间新增 2 条匹配行,旧实现会按 where 删除 55 条,界面没有告知数量已经变化。

根因

src/api/search.ts 的 resolveTargetRows() 在 selectOption === 'all' 且没有 taskId、hasEmailOnly、keyword 客户端过滤时返回动态 jsstoreQuery。apiLocalDataDelete() 随后把该 where 直接交给 deleteByQuery(),使删除目标在执行时再次求值,而不是确认时的固定对象集。

单独在删除前 countByQuery() 不能修复:计数和删除是两个异步操作,后台仍可在两者之间写入。

修复方案

  1. 调用方把确认框显示的 selectTotal 显式作为 confirmedTotal 传给删除 API。
  2. all 的无客户端过滤路径先按 where 查询匹配行并固化 ID。
  3. 所有 all 路径的固化 ID 数量与 confirmedTotal 一致时,仅执行 deleteByQuery({ id: { in: ids } })。
  4. 数量不一致时在删除前抛出“筛选结果已变化,请重新确认”,现有 toast error 分支向用户展示。
  5. 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,并在任何写操作前校验。