Skip to content

一个人当 QA:
上线前我把十七个问题钉到了代码行 ​

一句话结论:自查清单最容易犯的错,不是漏项,是每条都停在现象——能复现、能描述,但没人知道该从哪改。

一条主链串行、四条支线并行:先修能让流程跑通的那条

一、十七个问题,和一堆描述 ​

上线前做了一轮真人走查:从注册、装好、第一次对话,到跑一个真任务、看产物、翻设置。走完收了十七个问题。

第一版清单长这样:某个按钮点了没反应、某处提示语在窄窗口下被截断、某个任务跑完产物面板是空的、某个页面切换后状态丢了。

每条都能复现,每条都配了截图。拿给任何人看,都承认这是问题。

但清单交出去之后卡住了——没有一条写清楚该改哪里。

二、现象清单为什么不够用 ​

因为没有测试团队的时候,清单的第一个读者是下一个我。而「按钮点了没反应」这句话,第二天再看,等于让我把排查过程再走一遍:是前端没绑事件?接口 404?还是权限拦了?

十七个问题,就是十七次重新排查。

第二版换了要求:每条必须给出已核实的根因。不是猜的方向,是核过的位置——触发条件、代码里的判定条件、为什么这一版才会出现。

有一类问题最麻烦:症状相同,成因不同。列表页空态和详情页空态看着都是「空白」,但一个是数据没返回,一个是组件判断条件写反了。清单里如果只写「空白」,修的时候必然会修错一个。

还有一条我特意没写满:十七个里有一个,压到了两个候选原因,差一行日志就能定死。这一条单独标出来,写明「未定死」,不冒充结论。

清单可以有不确定项,但不能有不标注的不确定项。

三、定完根因,纪律更重要 ​

清单定稿那天立了两条规矩,后面看这两条比清单本身值钱:

第一条:修的时候不许重新走查、不许重新定根因。 听起来反直觉——发现问题不该多查几遍吗?实际是,每查一遍,结论就会微调一点点,改到第二轮、第三轮,清单上写的位置和实际改的位置已经对不上了。最后没人知道哪条改了、哪条没改。

第二条:改动按优先级排队,一条主链串行,四条支线并行。 主链是「让完整流程能跑通」的那几处,必须串行——它们互相依赖,同时改会互相盖住。支线是相对独立的(提示语、窄窗口布局、空态文案),可以并行。主链没走完不开新线,否则会同时出现五个半成品,验收时分不清是谁的锅。

四、顺手纠正的两处假线索 ​

走查过程里有两处一开始判错了,后面又自己推翻:

一是把「环境缺口」当成「产品缺陷」。有几条失败其实是环境问题——付费搜索没充钱、某个任务环境里缺一个工具。这类问题写进清单会让后面的人白改一遍。

二是把「偶现」当成「必现」。有一个问题连着两次复现,就写成了必现;再跑五次,变成两次里出现一次。清单里必须写清复现率,否则修完的人会以为修好了,验收的人一跑就说是没修。

五、这套方法能复用的地方 ​

一个人干活,最缺的不是时间,是能让第二天的自己接得上手的信息。所以任何清单都该满足三个条件:

  • 每条能定位:说清在哪、什么条件触发、为什么这一版会这样;
  • 每条能验收:写清修完怎么验证,最好是能一次跑出来的一条操作;
  • 不确定的必须标出来:宁可写「待定」,不写「大概是这样」。

具体到产品里,常见问题的口径都整理在常见问题;走查本身的方法,比清单内容更值得抄。

结论 ​

  • 只描述现象的清单,等于把排查成本转嫁给下一个人;
  • 定根因和改代码要分成两件事做,混在一起就会来回摇;
  • 优先级不是「哪个最容易修」,是「哪个卡住了整条流程」;
  • 清单里最该写清的是不确定项——它决定后面的人是继续挖,还是直接改。