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):
⇒ 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」时一并处理:吞错改上抛 + 数据条未知态)。