DataGrid 内部 Uncaught TypeError 会白屏整个数据页 —— 加边界,根因待复现
现象¶
Tony 的 chrome://extensions 错误面板:
Uncaught TypeError: Cannot read properties of null (reading 'id')
上下文:main.html
堆栈:chunks/client-data-table-C_GLsQZ0.js:94(匿名函数)
第 94 行的代码片段里能看到 openedPanelValue、csvOptions、ignoreValueFormatter ——
是 MUI DataGrid 的 filter panel / CSV export 那一段(打包后已 minify)。
排除掉的嫌疑¶
- 列定义:
fieldsData从useState(DEFAULT_FIELDS)声明起从没被写过 (grep setFieldsData只有声明那一处),列来自固定常量,不可能有null项 - 我们自己没有设
filterModel/onFilterModelChange(grep 无命中),用的是 DataGrid 内部状态
⇒ 触发条件在第三方 minified 代码里,静态看不出来。
处置:加边界,不猜根因¶
不做猜测性修复。 与其改一处「可能有关」的代码,不如先解决最大的可见伤害:
没有 error boundary 时,DataGrid 内部一抛,整个数据页白屏 —— 用户只能重开扩展, 而且他看不到任何错误(那条 Uncaught 只出现在
chrome://extensions的错误面板里,没人会去看)。
⇒ components/table-error-boundary.tsx:
- 抛错时显示「表格没渲染出来 / 数据没有丢 / 重试」,并把错误原文摆出来(便于反馈)
- componentDidCatch 里留一行 console.error —— 否则这类错误对用户完全隐形
待复现¶
需要 Tony 提供触发路径(他当时的操作:点视图齿轮 → 打开筛选面板)。
复现到之后再定位根因,届时把本条从 observing 转 fixed。
元教训¶
第三方组件的内部错误,第一优先是「别让它扩散」,不是「立刻猜出根因」。 一个 30 行的边界能把「整页白屏 + 零反馈」变成「一条可复制的错误 + 一个重试按钮」, 而猜测性修复的期望收益是负的:改错了会引入新问题,改对了也无从验证。
🔴 根因(v0.16.24 —— 装了 jsdom 之后当天复现)¶
已确证¶
rows 数组里只要混进一个 null,MUI DataGrid 读 row.id 时必抛这条错,
且抛在渲染期。jsdom 实测,钉在 tests/sanitize-rows.test.tsx 第一条。
同一个 null 在 use-data-source.ts 里还会炸两处:
默认排序 (b.id || 0) - (a.id || 0)、以及 list.map((row) => row.id)。
顺带订正 v0.16.21 的一句声称(glm53 X_FAKE②):当时说「DataGrid 内部一抛不再白屏整页」, 覆盖面讲大了 —— error boundary 只接渲染期。这条路径确实在渲染期,所以边界接得住, 但那是实测之后才能说的,当时并不知道。
仍未确证¶
null 究竟从哪来。候选是 jsstore/IndexedDB 在某些删除或版本升级竞态下返回含空洞的数组 —— 我没有证据,不写成结论。
一条旁证:use-data-source.ts 的 optimistic delete 过滤写的是
!opts.optimisticDeletedIds.has(r?.id) —— 那个可选链说明有人遇到过 r 是空,
只是当时按「加个 ?. 绕过去」处理了,没往上追。
修法:入口净化 + 留痕¶
src/utils/sanitize-rows.ts,接在两个位置:
fetch-rows-snapshot.ts—— 数据页行快照的源头use-data-source.ts的tableData出口 —— DataGrid 的唯一入口,两种 mode 都走它
为什么不在下游各处加 ?.:下游有十几处读 row.xxx,各自防等于十几条各不相同的判据,
漏一处就复发。本仓刚在「同一判据分叉三处」上栽过(0205-quick-mode-predicate-forked)。
🔴 不静默:丢了行就 console.warn 带数量和样本形状。
真丢了行是数据层出问题,吞掉等于把数据完整性事故伪装成一切正常,下次仍然没线索。
判据¶
tests/sanitize-rows.test.tsx 7 条,三次变异验证(不过滤 null / 误杀 id=0 / 删掉 warn)全部命中。
其中「id 为 0 是合法的」那条防的是修复本身的误伤 —— 主键从 0 开始的库不该被整个清空。
🔴🔴 v0.16.25 订正:上一版的「已确证」是错的(dshf 对抗审查 X_FAKE①②③)¶
送审后审查方实测证伪三条,我复核全部坐实:
① 复现用错了接线¶
v0.16.24 我写「喂 null 给 DataGrid 必抛 reading 'id',jsdom 实测复现」,
用的是裸 DataGridPremium,没有 getRowId。
而生产的两个 wrapper 都是 getRowId={(row) => row?.[rowKey]}(带可选链,
client-data-table.tsx:213 / data-table.tsx:193),商家列表走的是后者。
实测两种接线抛的是完全不同的错误:
| 接线 | 抛什么 |
|---|---|
| 裸 DataGrid(我测试里的写法,生产没有) | Cannot read properties of null (reading 'id') |
生产写法(getRowId 带 ?.) |
MUI X: ... requires all rows to have a unique 'id' property. |
⇒ 那条复现证明的是「某个 DataGrid」,不是「本 App 的 DataGrid」。
② 「唯一入口」不成立¶
我据此决定「下游全部不用加 ?.」。实际 src/sections/page-results/index.tsx
是另一条活入口,绕过 use-data-source。承重论证塌了。
③ 最要紧:净化放错了位置¶
use-data-source.ts 内部这两处才是真正抛那条错的地方:
list = [...list].sort((a, b) => (b.id || 0) - (a.id || 0)); // null → reading 'id'
const allIds = list.map((row) => row.id); // null → reading 'id'
而我 v0.16.24 把 sanitizeRows 放在 tableData 出口 —— 在它们的下游,
对它们毫无作用。审查方原话「实测在出口净化已在位的情况下仍可复现同一异常」,属实。
⇒ v0.16.25 把净化移到 clientPaged 的源头(opts.rowsSnapshot 刚进来时),
整条链(过滤/排序/map/slice)才真的安全。
根因现状(如实)¶
- ✅ 已确证:
use-data-source那两处对 null 抛的正是 ISSUE-0202 那条错误 (tests/use-data-source-null-rows.test.ts钉住,含「净化放下游等于没放」那条) - ❓ 仍未确证:null 从哪来。旁证仍是那个
has(r?.id)的可选链。
教训¶
「我构造了一个场景复现出同样的报错文本」不等于「我找到了生产里的那条路径」。 报错文本相同只是必要条件。验根因必须用生产的真实接线, 不是一个能产出同样字符串的最小样例。