「页面出现了一点问题」,
问题不在页面
一句话结论:整页白屏的时候,最该怀疑的不是页面写得烂,是它拿到的数据不是它以为的形状。

一、新版本装完,第一件事就撞墙
新版本装好,我习惯先点一遍改动过的地方。这次改的是设置页——文件访问那一块从「全拦」改成了分级授权,多了几个列表:受管目录、默认目录、额外放行的系统目录、被移除的系统目录。
点进去,整页没了。
屏幕上是一句很客气的提示:页面出现了一点问题,请重试。下面一个重试按钮。点了,还是这一页。刷新,还是这一页。
新功能一上手就整页崩,这个信号很难看。我第一反应是:肯定是这块配置写坏了,某个字段存了个非法值。
二、清空配置也一样
把配置清空,重启,再点。还是这一页。
把配置恢复成出厂状态,也一样——四个列表全是空的,一个值都没有。
到这一步,判断就反过来了:不是数据坏了,是「没有数据」这件事本身把它弄崩了。 全新安装的机器上,这几个列表本来就是空的——空才是触发条件。
三、根因:空,有两种形状
在程序里,「空列表」和「没有这个列表」是两回事;但序列化成 JSON 之后,它们很容易变成两种形状:[] 和 null。
后端在做这份配置快照时,用了一个很常见的写法:把一个可能为空的切片复制一份返回。问题在于,如果来源本身就是空的,复制出来的还是空指针,序列化出去就是 null。
前端那边,模板里直接写了「读这个列表的长度」——空数组读长度是 0,没问题;null 读长度就是抛错。一个字段抛错,整个页面渲染中断,被最外层的错误边界接住,于是整页换成了那句「页面出现了一点问题」。
所以那句提示其实没说错:页面确实出了点问题。但它把原因指向了页面,而真正的原因在接口的另一头。
四、为什么只有这一页崩
同一份数据里还有别的列表,它们没出事。区别只有一处:那些地方在读之前先兜了一下——拿到的不是数组,就当空数组用。
出事的这几处是这次新加的,写的时候默认「后端一定会给数组」。这个默认在九成情况下成立,在「全新安装」这一种情况下不成立。
也就是说,这个 bug 只会在最干净的环境里出现——恰恰是新用户第一次打开时的环境。
五、更让我后背发凉的是下一层
修法很清楚,两侧都改:后端保证空就是 [],前端读之前也兜一下。半小时能改完。
但在查的过程中,我注意到了另一件事。
这个整页兜底其实是个「好事」——它至少没让用户看到一地碎片。可它捕获错误之后,只往控制台打了一行日志,没有上报。
意味着:如果这一页是用户先点开的,我知道这件事的唯一途径,是他截图发给我。查日志?日志在用户的机器上。看后台?后台什么都没有。
一个把错误吃掉、又不告诉任何人的兜底,比不兜底更危险。不兜底至少还会炸得响一点。
所以这次一并改了三处:后端补形状、前端补兜底、兜底组件补上报。
六、这件事教我什么
- 「空」有形状。 空列表和不存在,在类型系统里是两件事,在 JSON 里也是。约定哪一种,就得在两侧都守住;
- 只在最干净的环境里复现的问题,最值得优先修。 因为那正好是新用户的第一印象;
- 兜底组件必须有出口。 捕获了不上报,等于把故障藏起来;
- 整页崩的时候,先看它拿到了什么,不要先看它写了什么。
这个能力现在是什么样、适合谁用,见个人版介绍。