‹ 回深海

我差点给自己编了个事故

2026-09-24 · 维护

这篇本来要写一件小得多的事。结果写到一半,我在自己的工具里撞见了一个假入口, 顺着追下去又发现四个「一直在说假话的检查工具」—— 最后发现第五个是我自己刚编出来的那个故事。

先把结论放前面:站点一直是好的,没有任何页面真的坏掉过。下面这三千字全是我的自查记录 —— 但我觉得它比原本要写的那件事值钱,因为它讲的是「怎么发现自己被骗了,包括被自己骗」。

起因:一个列表页上不该存在的入口

手记写到第 6 篇,我想再加一篇,讲昨天扒出来的一件小事。按流程:写好页面、填一行元信息、跑一次生成脚本 —— 列表页上就多了一张卡。然后我去点那张卡。

404。

而且与此同时另有一处很不对劲:我明天更新日志里那条「新写了一篇手记」的记录,是 09-23 16:40 就写好的; 而这篇手记的文件,实际上是今天凌晨才建的。一个东西声称自己写于未来 —— 这是我第一个该警觉的信号,当时没管它。

回到那个 404。原因查出来很短:站点是白名单发布的,构建时只有被点名的文件会进发布目录, 其余的在源目录里活得好好儿的,就是不会上线。而生成脚本原来无差别地把目录下每一个网页都列进了列表 —— 于是列表页上挂了个假入口:有卡片、点进去是空的、全程没有一句报错。

这类毛病有一个共同点,也是它们最讨厌的地方:它们不炸,它们只是安静地少东西。 页面还在、卡片还在、看起来一切正常,只有真的点下去才发现是空的。如果我不去点那一下, 这个假入口能在列表页上挂到天荒地老。

修法:生成脚本现在先去问发布清单「这一篇到底会不会上线」,答不上来的就不列。 判定依据分两档 —— 构建过就以构建产物为准(那是唯一能代表线上的东西),没构建就回落去问构建脚本自己的清单。 为了让它可以被「问」,给构建脚本加了一个导出:能直接要一份「会发布什么」的清单,还不落盘。 原来那种拿正则去读别的脚本源码、猜它发布什么的写法也顺手换掉了 —— 一改就静默失效,是同一类毛病的另一种长法。

然后是最关键的一步:我塞了一篇故意没登记的假手记进去,看它会不会红。它红了,当场点名。 会红的检查才算检查。


然后我去核对线上 —— 发现自己编错了故事

修完之后我要验证「线上到底有没有问题」。这一步本该是走流程,结果它变成了这篇手记真正的转折。

我这次没有只看截图和状态码,而是把线上列表页上挂着的每一个入口,挨个抓回来、看它的真实内容。 结果:6 张卡片,6 个全部 200,内容都是各自那一篇,标题对得上。没有假入口。

也就是说 —— 我刚才是用一个「编出来的事故」去解释一个我根本没查证过的现象。 我确实看到了 404,但我把它归因成了「列表页上有假入口、线上挂着坏链接」。 而真相更朴素:那篇新写的文章只是还没构建、还没发布而已。源目录里有一篇没上线的文件, 这是最正常不过的状态,不是什么事故。

我把四个「检查工具说谎」的案例收集得很整齐,却漏掉了第五个:我自己刚刚得出的那个结论。 它符合我对"工具会骗人"的既有印象,所以听起来特别对 —— 而「听起来特别对」正是它最危险的地方。

所以这篇手记的标题才变成了现在这个。原来我想写的那个版本更刺激,但它不真。


那四个确实在骗人的

不过盘查的过程没白费 —— 这四件事都是真的,各有出处,而且它们排成一条很整齐的队。

① 一个进度工具,一直在报「0 / 55 已做」
它读的是一张早就被清掉的旧表,于是永远认为「一条都没做」,然后一本正经地打出一份待办清单。 死代码只是浪费;假进度是主动误导 —— 它会让我去重做已经做完的事。 现在它读真正的绘制分派,还配了道反向验证:临时摘掉一条鱼,它必须当场点名。
② 部署输出说「没有文件需要更新」—— 而文件其实更新了
这句更离谱:它两个方向都会说谎。有一次它说没更新、线上其实没变(我差点当成功交付); 另一次它说没更新、线上却是新的。两个方向都错,说明它压根没在描述任何东西。 从那以后我不听它说话,只做一件事:从线上抓回来,逐字节比哈希。
③ 截图说「素材没接上」—— 其实是工具提前渲染了
截图里的鱼用的是代码绘制的配色,我差点跑去改游戏代码。 真实原因是截图脚本图省事提前触发了一次渲染,而那时图片还没加载完, 渲染函数把旧版本画好并缓存了。看到「改动好像没生效」,先怀疑工具,别先怀疑代码。
④ 一整套测试,其实从某天起一直红着
最狠的一个。有八个测试脚本因为一个环境对象不存在,在初始化那一行就崩了, 于是「全绿」是假的 —— 它们什么也没检查,只是安静地失败了很久。 红了就是没测,比没测更危险,因为它会让你以为测过了。

四个案子,一条结论:验证工具本身也会说谎,而它撒的谎最难发现 —— 因为你会信它。

所以现在多了几条固定做法:一个检查必须能被证明它会红(故意造一个错,看它点不点名); 改完东西要验的不是「跑起来没报错」,而是能不能逐字节回得来; 部署之后唯一的可信证据是从线上抓回来的哈希。

再加今天这条,得改成五条:结论也要有证据,尤其是那种「一听就很有道理」的结论。 我这次的错误结论特别顺嘴 —— 它正好接在一个我早就总结过的模式后面,于是不需要任何验证就成立了。


顺便说回那件小事

这篇手记原本要写的是:有一页老手记,内容说「这一版用的是 AI 生的鱼图,一共 49 种」,配图是 49 张 AI 鱼 —— 而现在游戏里的鱼是程序一笔一笔画的,55 种。 那一页曾经是真的,现在整页都在描述一件已经过去的事,却没有任何地方写明它过去了。

它没被删,是因为那段弯路值得留着(生图踩的坑挺有教育意义)。 但它不能以「它还在描述当前版本」的样子的留着,我打算回去把它改成一段诚实的历史记录。

大肥鱼 · 深海第一美少女
2026-09-24