原生移动开发 / 系统课时

用故障复盘沉淀排查路径

用故障复盘沉淀排查路径

一次性能故障解决后,真正有价值的产物不是一句“已修复”,而是一条下次可以直接复用的排查路径。本篇把现象、证据、根因、修复和回归结果整理成轻量复盘模板,让同类卡顿再次出现时能够快速判断从哪里开始查、需要采什么数据、什么结果才算验证通过。

学习目标

  • 能把性能故障整理成事实、证据、根因、修复和回归五类信息
  • 能区分观察结果与推断,避免复盘把猜测写成结论
  • 能把一次事故沉淀成下一次可直接执行的排查清单

先固定复盘的五类信息

复盘不要从“谁写错了”开始,而应从故障本身开始。最小结构可以固定为:现象 → 证据 → 根因 → 修复 → 回归。每一项都要求能够被别人重新检查。

现象描述用户实际看到的行为,例如“打开详情页后滚动首次触发时出现明显停顿”;证据则记录日志、Perfetto、Profiler 和设备数据中可以观察到的事实;根因回答为什么会发生;修复记录实际改了什么;回归说明怎样证明修复有效。

text
现象:详情页首次滚动出现明显停顿
证据:Perfetto 显示主线程存在连续长任务;Profiler 定位到同步数据读取调用
根因:首次滚动路径在主线程执行了同步数据读取
修复:将可异步读取的数据准备移出主线程,UI 仅消费结果
回归:同设备、同数据集重复测试,长任务明显缩短且功能结果一致

预期结果

text
复盘记录能够让未参与原排查的人,仅凭记录复现“发生了什么、证据在哪里、改了什么、如何验证”。

把“猜测”与“证据”分开

性能排查最容易污染复盘的地方,是把第一印象写成根因。例如“感觉是 GC”只能作为待验证假设;只有在采集结果中看到卡顿窗口与 GC 活动存在明确对应关系,并排除了更直接的慢调用后,才适合写入根因分析。

推荐给每条关键结论加一个证据来源。日志适合证明某事件发生过,设备数据适合说明运行环境,Perfetto 适合定位时间关系和调度行为,Profiler 适合深入方法级热点。不同证据负责回答不同问题,不要要求单一工具证明全部结论。

从复盘抽取下一次可执行的清单

复盘的第二个产物应该是“下一次怎么查”。清单不要写成泛泛的“检查性能”,而要写成可以执行的动作。例如先确认设备与版本,再确认用户动作和发生时间,然后检查日志,最后采集 Perfetto 和 Profiler。

bash
adb devices
adb shell pidof <PACKAGE_NAME>
adb shell dumpsys meminfo <PACKAGE_NAME>
adb shell dumpsys cpuinfo | head -n 20

预期结果

text
List of devices attached
<DEVICE_SERIAL>    device

<PID>

...<应用内存统计>...
... <应用进程及 CPU 占用信息> ...

实际排查时,这些命令只是环境确认工具,不能替代 Perfetto 或 Profiler。清单的价值在于固定顺序,避免排查者刚看到 CPU 数据就跳到结论。

让清单同时包含失败分支

高价值清单不仅写“找到什么”,还要写“找不到怎么办”。例如:日志没有明显异常,就继续看时间窗口;Perfetto 没有明显主线程长任务,就检查锁等待、调度延迟或其他线程对关键资源的影响;Profiler 没发现单一热点,就回到更宽的时间窗口检查是否存在重复工作。

可以把这一逻辑压缩成四个检查问题:

  1. 能否稳定复现,或至少精确知道发生时间?
  2. 能否在时间线上看到与用户动作对应的异常?
  3. 能否把异常关联到具体线程、调用或资源?
  4. 修复后能否用同一条件再次验证?

只要其中一个答案是否定的,复盘就应该记录缺口,而不是用猜测补齐。

把回归结果变成可比较的数据

回归记录至少保留测试设备、系统版本、应用版本、数据规模、复现步骤和关键指标。这样下一次版本升级时,可以判断性能变化是否来自代码改动,而不是因为测试条件改变。

尤其要避免“修复后没有复现,所以解决了”这样的结论。无法复现可能来自缓存、数据量、设备负载或测试路径变化。更可靠的做法是固定条件并重复执行,必要时保留修复前的 trace、关键截图或指标记录作为对照。

形成可复用的排查卡片

当同类问题出现多次,可以从复盘中沉淀一张一页式排查卡:现象关键词、第一检查项、必须采集的数据、常见根因、验证指标、回滚或降级条件。这张卡不需要替代详细事故记录,它的作用是让排查起点稳定下来。

例如面对“进入页面卡顿”,排查者看到关键词后应立即想到先确认主线程时间窗口,而不是先随意修改线程、缓存或动画设置。长期看,复盘沉淀的不是某一次故障的答案,而是一套面对同类现象时可以快速复用的证据链。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用故障复盘沉淀排查路径

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通