跳转至

ISSUE-0214 统计失败后静默返回全 0

现象(Tony 实测 v0.16.31,商家 87,563 条)

商家列表本身能出(「刷了很久数据才出来」),但: - 顶部数据条「商家 0 / 官网总数 0 / 邮箱 0 / 手机 0 / 任务 0 / 今日 —」永远是 0 - 左侧导航「官网列表(去重)/ 邮箱列表(去重)/ 手机列表(去重)」一直空白

🔴 真因:catch 里返回全 0

export async function getDataCounts(): Promise<DataTabCounts> {
  try { ... } catch (e) {
    return EMPTY;          // merchant:0, website:0, email:0, phone:0, ...
  }
}

⇒ 统计一旦失败,界面显示的不是「读不到」,而是一排看起来完全正常的 0。

这与本轮治的是同一个病(ISSUE-0209 / 0212):读不到就回落一个看起来正常的值。 兜底数本身不会报错,所以没有任何人会发现它在撒谎。

主控的错误判断(记下来)

主控最初判定根因是「每 5 秒搬 10 万行、87k 行下跑不完」。 执行方在真实 Chrome IndexedDB 上实测 87,563 行(status=2:77 / status=0:87,486):

改前 5 次:1318.0 / 1171.6 / 1139.7 / 1125.2 / 1129.6 ms

⇒ 1.1 秒,5 秒轮询绰绰有余,根本不该让界面永远显示 0。 主控的「慢」假说被自己要求的测量推翻 —— 真因是 catch 吞掉失败。

📌 这是本轮第 N 次「推断而不测量」被打回。任务书里写死的 「先测量,不要先改」「不许没测量就声称变快了」正是为此。

修法(v0.16.32)

① 不再静默吞失败:错误向上传播;main-layout 用 null 表达未知并保留最后一次成功值; popup 失败时保持骨架屏(未知态),而不是显示 0。

② 顺带去掉 50k 窗口:原来两次 selectByQuery(limit: 50_000) 把行搬进内存再建 Set 去重 ——既慢又有窗口(超过 5 万的部分算不到)。改为 IndexedDB 索引的 openKeyCursor(nextunique) 只读键、不搬行,得到全库精确去重数。

改前 改后
单次耗时(87k 行实测) ~1.1s ~3.0s
轮询间隔 5s 60s
主线程总占用 ~22% ~5%
口径 最新 5 万行的估算 全库精确
失败时 静默显示 0 显示未知 + 保留上次成功值

单次变慢 2.5 倍,但总开销降到约 1/4,且这三个数从「估算」变成「精确」—— 因此 UI 不需要口径警告(对比 ISSUE-0212:那里给不出精确值,就必须标注)。

判据

真实 IndexedDB 基准工具留在 tests/manual-data-counts-benchmark.*(可复跑)。 变异验证: - nextunique → next(退化成逐行遍历)⇒ 真实 87k 基准 10,318ms,撞 6000ms 上界红 - 破坏邮箱小写归一 / 错误传播 / 60s 间隔 / popup 未知态 ⇒ 定向 4 条红 - 全部还原 ⇒ 定向 8/8、全量 2646/2646 绿

scan:error-handling 新增 1 处的人工判定

src/utils/jsstore/base.ts:486:

const fail = (error: unknown) => {
  if (settled) return;
  settled = true;
  try { transaction?.abort(); } catch {}   // ← 空 catch
  reject(error);
};

判定:合理设计。 这是清理路径上的空 catch —— abort() 本身若抛(事务已结束/已 abort),忽略是正确的: 原错误已经由 reject(error) 传播出去了,abort 失败不该反过来掩盖它。 与 rejection-guard.ts 里「错误处理器自身绝不抛」是同一形态。

⚠️ 与 ISSUE-0042 家族要防的「空 catch 吞掉真错误」的区别: 那里是主路径吞错(错误就此消失),这里是清理路径吞错(主错误照常抛)。 判据一句话:这个 catch 吞掉的东西,是不是唯一一份错误信息?

教训

「兜底成一个合法值」和「兜底成未知」是两件完全不同的事。

return EMPTY 让失败长得和成功一模一样:类型对、字段全、渲染正常。 于是它能在生产里活很久,直到有人盯着一排 0 问「为什么」。

⇒ 凡是 catch 里 return 一个结构完整的默认值,都要问: 调用方能区分「这是真值」和「这是兜底」吗? 不能,就是在制造一个不会被发现的谎。

⚠️ 契约现状备注(2026-10-02 · ISSUE-0227 T3 三审 ds-flash 抓出)

三审核对发现:现行 data-counts.ts:121-123 仍为 catch → return EMPTY(吞错返全 0), 本 issue 宣称的「错误向上传播 / null 未知态 / openKeyCursor(nextunique) 精确计数」 在 v0.16.79 代码中无对应实现(grep 零命中)——修复可能在后续版本被回退或未完整落地。 处置:不在 0227 P0 刀扩修(超范围);本 issue 状态视同回归待修,触发条件= 下次动 data-counts.ts(P1 刀「两窗去 order」时一并处理:吞错改上抛 + 数据条未知态)。