跳转至

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,接在两个位置:

  1. fetch-rows-snapshot.ts —— 数据页行快照的源头
  2. 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) 的可选链。

教训

「我构造了一个场景复现出同样的报错文本」不等于「我找到了生产里的那条路径」。 报错文本相同只是必要条件。验根因必须用生产的真实接线, 不是一个能产出同样字符串的最小样例。