防抖依赖吃引用 → 定时器饿死¶
一个 P0,三种机制,同一个后果¶
快速模式 Alert 上的「切到完整模式」按钮,是用户查看/删除 5 万条窗口之外老数据的唯一手动入口。 三轮修改把它弄消失了两次,每次机制都不一样:
| 轮次 | 改动 | 后果 |
|---|---|---|
| 初版 | 判据 gap > 0,无防抖 |
Alert 闪烁(两个异步源刷新错位,差值符号来回翻转) |
| 第一次修 | 滞后阈值 >20 才亮 + !isRunning |
🔴 isRunning 是采集引擎总开关(默认 true、空闲不自动关),不是"正在采集" ⇒ Alert 永不渲染,入口消失 |
| 第二次修 | 去掉 !isRunning,判据回 gap > 0,翻转时 setTimeout 3 秒确认 |
🔴 依赖数组写成 [merchantStats.total, rowsSnapshot, ...] —— rowsSnapshot 是数组引用 ⇒ 采集中被事件刷新持续换新 ⇒ effect 重跑、cleanup 清 timer、重新排程 ⇒ 3 秒永远走不完 ⇒ 入口在采集中依旧消失 |
| 第三次修(当前) | 依赖改成标量 quickModeGapPositive |
✅ 只有差值正负号真的翻转才重跑,引用漂移不再触发 |
根因¶
data-view.tsx:371 监听 background 的 maps-data-updated 事件,收到就 refreshRows()。
采集进行中这个事件远比 3 秒频繁,于是:
数据落库 → 事件 → refreshRows() → rows 换新数组引用
→ useEffect 依赖变化 → cleanup 清掉 timer → 重新排程 3 秒
→ 不到 3 秒又落库一批 → 循环
quickModeGapStable 永远停在初始的 false,渲染条件恒假。
防抖窗口被刷新频率吃掉了。 而它的表现不是"防抖不生效"(那样只是闪), 是"功能整个消失"——比原来的 bug 更严重。
判据(可复用)¶
🔴 防抖 / 节流的依赖数组里,不能有每次刷新都换的引用。 判据必须是标量(布尔、数字、字符串),且只在语义真的变化时才变。
自查方法:把依赖逐个问一遍「它多久换一次新值?比我的延迟短吗?」 短的那个会把定时器饿死。数组、对象、函数默认都是"每次都换",除非被 memo 过。
以及这一轮更贵的教训:
🔴 一个判据加进渲染条件之前,先问"它为假时用户失去什么"。 三次里有两次都是同一个形态:为了修一个体验问题(闪烁), 往渲染条件上加了一个新的合取项,而那个项在真实场景里恒假。 闪烁是体验问题,入口消失是功能问题——不能用后者换前者。
同批次的其它 finding¶
对抗审六个 lens 在同一批改动上还抓到:
| 级别 | 问题 | 修法 |
|---|---|---|
| P1 | Alert 可见性走防抖态、文案里的条数用实时值 ⇒ 会渲染「还有 -1,204 条老数据」 | 数字 Math.max(1, gap);出现/消失仍由防抖态独占 |
| P1 | 三来源的号把「社媒」折进 +1 —— 唯一的权威来源被确定性藏起来 |
新增 orderPhoneSources,权威来源永远排第一 |
| P1 | variant="filled" 的 social chip 在打印件里整个消失(浏览器默认不打印背景色,label 是白字) |
两档都改 outlined,区分放在 border-style(实线/虚线),不依赖背景 |
| P2 | 生产侧自带第二份标签表 const LABEL = {maps:'地图',...},与 PHONE_SOURCE_META 无绑定 ⇒ 「标签不含分段符」的契约断言量的是另一张表,改任一处全部测试照绿 |
sourceText 收成 buildPhoneSourceText 单一实现 |
| P2 | chip「全部」单独换成 5s 节拍 ⇒ 同一行内 已挖掘 + 待挖掘 ≠ 全部 |
回退:宁可整组一起慢,不要一个数字单独快 |
| P2 | 采样提示在按任务筛选时说「总数据 300 条,超过采样上限 50,000 条」 | 文案改为陈述事实,不做大小比较 |
| P2 | sources 次序随处理先后漂移 ⇒ 同一组合两种字符串 ⇒ 排序分组是假的 |
buildPhoneSourceText 先做顺序归一 |
「判据在量别的东西」——我自己又犯了一次¶
这个仓库把「判据在量别的东西」立成铁律,而本轮写这条闸的人自己踩了:
- 加了
PHONE_SOURCE_SEP常量,注释写「已被契约断言闸住」 - 断言量的是
PHONE_SOURCE_META的 label - 生产路径用的是另一份
LABEL字面量
⇒ 注释声称的保护不存在,改生产那份全绿。
🔴 加"契约断言"之前,先证明断言量的对象和生产路径用的是同一个。 最可靠的做法不是加断言,是先把重复的字面量收成一处 —— 断言守的是单一源,才有意义。
对抗审的收口¶
六个 lens 共报 39 条,每条三路独立证伪(代码事实 / 可复现性 / 严重度), 存活 4 条,全部 P2/P3,P0 = 0、P1 = 0。存活的都已修:
| 级别 | 存活 finding | 处置 |
|---|---|---|
| P2 | 采样提示的展开文案把 truncated 解释成「total 超过采样上限」——两条路径上它是两个不同的量:无 taskId 时是 total > sampleSize(sampleSize 不含 status=3 失败行),有 taskId 时是 allRows.length >= ROWS_CAP(撞的是全表窗口,与该任务的 total 无关) |
文案分路径重写,不再做大小比较 |
| P3 | 测试注释把 requiresFilterValue 的作用说反 —— 它不影响筛选是否生效,唯一消费点是 useGridFilter.js:138 的 showFilterPanel(决定 value 为空的项在重开面板时是否被剔除) |
注释订正 |
| P3 | 源码断言的切片用裸字面量 field: 定界 —— 实测往列里补一句含 ASCII 冒号的中文注释,四条无关断言一起假红 |
终止符改 /field:\s*'/;sourceText: 的固定字符窗口改语义边界 |
| P3 | HEADER_BG 自称「顶栏底色的单一源」,却漏了 content 布局的 header.tsx(同样 height:40, px:1, bgcolor:'#F4F6F8')—— 落点选在组件文件里,第三个消费者就被漏掉 |
常量移到 layouts/common/constants.ts,三处同引 |
🔴 最后一条的教训值得单独记:「单一源」这个词是一个可证伪的声称。 写下它之前要 grep 一遍还有谁在用同一个值 —— 把常量放在某个组件文件里导出, 几乎必然漏掉不 import 那个组件的消费者。中立位置(constants / theme)才配叫单一源。
🔴 假红也是缺陷:断言被无关编辑触发时,排查方向会被引向错误的地方, 比没有断言更浪费时间。定界要用语义边界,不要用字面量或固定字符窗口。
验证¶
- 21 条定向变异 21/21 被抓(含对抗审点名的全部 7 条「改坏了但全绿」构造)
- 假红构造复现验证:往 sourceText 列插入含
field:的注释后测试仍绿(修前会四条同时假红) pnpm verifyrc=0、npx vitest run1520 全绿、tsc --noEmitrc=0、pnpm buildrc=0- 对抗审 39 条 → 三路证伪 → 存活 4 条(P0=0 P1=0),已全部修复