记录复查过程的核心做法是:为每个问题建立一条可追溯的记录,写清首次发现时间、现象证据、判断依据、处理动作、复查时间和复查结果。复查不是重新跑一遍工具就结束,而是对照上一次的证据确认问题是否消失、是否复发、是否只是被暂时掩盖。记录的目的是让下一次检查的人不必重新猜测,也能判断当时的结论是否仍然成立。
从结果倒推,一份合格的复查记录至少要能回答四个问题:上次看到的是什么,这次看到的是什么,两者差异说明什么,下一步由谁在什么时候做什么。如果记录只能回答“已检查,正常”,它对定位原因几乎没有价值。
HC-014,避免用“那个打不开的页面”这类无法检索的描述。复查结果不可比,最常见的原因是两次检查的条件不同。例如首次用手机网络访问,复查换成办公网络;首次检查的是带参数的地址,复查只测了首页。条件变了,现象消失或出现都不能直接归因于处理动作。
可执行的对比方法是:把首次采集时的关键条件逐项抄进复查记录,包括访问地址、请求方法、是否携带登录状态、使用的设备或客户端类型、检查时间。复查时尽量复现同一组条件,再额外补测其他条件。如果同一问题在条件 A 下消失、在条件 B 下仍存在,应记录为“部分改善”,而不是“已解决”。
适用条件是:问题现象可稳定复现。若问题本身是偶发的,应在记录中注明出现频率和观察窗口,例如“连续观察三天,每天检查两次,出现一次”,并说明这次复查是否落在同一观察窗口内。判断结果是:只有现象在规定窗口内不再出现,才可以标记为已解决;否则应保留为观察中。
复查过程适合按时间顺序记录,因为原因判断往往会被后续证据推翻。把每次动作和每次观察按时间排列,能清楚看出哪一步之后现象发生了变化,避免把最后一条结论当成唯一原因。
需要区分“可能原因”和“已经定位的原因”。同一现象可能有多个解释,例如页面加载慢可能来自服务端响应、资源体积、网络链路或客户端渲染。记录中应写成“目前证据支持服务端响应变慢,尚未排除资源体积影响”,而不是直接断定唯一原因。只有通过对照测试排除了其他解释,才把某项写成已定位原因。
复查记录如果没有责任人和触发条件,很容易停留在“待观察”。每条问题应写清谁负责下一次复查,以及在什么条件下必须复查:例如配置变更后、发布新版本后、观察到同类报错再次出现时。
验收标准要可判断。可以写成:同一地址连续三次检查均返回正常状态,且页面主要内容可正常加载;或同一报错在观察窗口内不再出现。避免使用“感觉正常了”“应该没问题了”作为验收结论。若问题依赖外部条件而无法自行验证,应在记录中写明验证方式和当前缺口,而不是直接关闭。
可以直接使用下面这个结构,每一栏都填具体内容:
HC-014 某页面间歇性无法访问关于具体工具,不同产品对检查项、历史记录和对比功能的支持范围不同,是否保留历史数据、能否按时间对比、导出格式包含哪些字段,都需要以实际界面和文档为准,不能假定某个工具一定具备某项能力。选择工具时,重点看它能否稳定输出可对比的原始证据,而不是只看汇总分数。
下一步,挑一个当前仍未关闭的问题,按上面的模板补全首次现象、判断依据和复查条件,然后在下一次检查时只改动其中一项条件做对照,把结果写回同一条记录。这样复查过程才会积累成可用于定位原因的依据。