原生移动开发 / 系统课时
完整排查一次卡顿故障
完整排查一次卡顿故障
本篇用一次完整的线上卡顿场景串起日志、Perfetto、Profiler 和设备数据:先确认现象,再缩小时间窗口与线程范围,定位主因,完成修复并用同一指标回归验证,最终得到可复用的排查证据链。
学习目标
- 能按固定顺序从用户感知、日志和设备数据确认卡顿范围
- 能结合 Perfetto 与 Profiler 判断主线程是否被错误工作阻塞
- 能用修复前后的同一场景和指标验证问题是否真正消失
先把卡顿变成可测量的问题
不要一开始就打开 Perfetto 搜索某一帧。先记录设备型号、Android 版本、应用版本、发生场景、复现步骤,以及用户感知到的具体表现,例如“点击列表项后约 1 秒无响应”。这些信息决定后续采集是否可比。
建议先建立一个最小故障记录:发生时间、页面、动作、预期响应时间、实际响应时间和是否稳定复现。线上问题还要保留对应版本、进程日志以及发生时的设备负载信息。

用日志和设备数据先缩小范围
先看应用日志是否在卡顿时间点附近出现数据库查询、磁盘读写、网络回调、GC、线程创建或异常重试。日志的作用不是直接证明根因,而是把 Perfetto 的观察窗口缩小到更有价值的几秒。
设备数据重点看 CPU、内存、存储空间、温度以及是否存在明显后台活动。若只有某型号设备出现问题,还要记录 CPU 架构、Android 版本和厂商特征;不要因为开发机上可以流畅运行,就否定线上样本。
可以先用 adb 确认目标设备和应用进程,再采集简短的系统状态信息。这里的包名和 PID 应替换成实际值。
adb devices
adb shell pidof <PACKAGE_NAME>
adb shell dumpsys meminfo <PACKAGE_NAME>
adb shell dumpsys cpuinfo | head -n 20预期结果
List of devices attached
<DEVICE_SERIAL> device
<PID>
Applications Memory Usage (in Kilobytes):
...<应用内存统计>...
... <应用进程及 CPU 占用信息> ...这些输出只能帮助确认设备和负载背景,不能单独证明“CPU 高就是卡顿根因”。下一步要回到卡顿发生的精确时间段。
用 Perfetto 找到卡顿发生在哪一帧
Perfetto 的核心任务是回答两个问题:哪一个时间段发生了异常,以及主线程当时到底在做什么。打开录制结果后,先围绕用户动作定位时间窗口,再观察主线程的连续执行片段、睡眠、锁等待和调度切换。
对于 UI 卡顿,优先关注帧时间与主线程。若一帧明显超过应用期望的绘制预算,不要立刻归因于绘制本身;继续向下展开该时间段,判断它是在执行 Java/Kotlin 方法、等待锁、等待 Binder、做文件 IO,还是因为 CPU 调度不到。
一个常见模式是“主线程看起来卡住,但真正耗时工作来自同步调用”。例如点击事件中同步读取数据库,Perfetto 会表现为主线程长时间执行相关调用链,而磁盘相关线程或内核调度又提供了佐证。此时日志可以告诉你发生了查询,Perfetto 才能告诉你它占用了哪段关键时间。
用 Profiler 验证热点而不是凭名字猜根因
当 Perfetto 已经把问题缩小到某个方法或调用链后,再用 Android Studio Profiler 做定点验证。重点查看 CPU 方法耗时、调用次数和线程归属;若怀疑内存抖动,再观察内存分配和 GC 情况。
例如看到 loadDetail() 很慢,不要直接把它写成根因。继续确认它是否在主线程调用、内部是否包含同步 IO、数据库访问或锁竞争,以及它是否每次点击都会执行。
一个有效的证据链通常长这样:用户点击 → 主线程出现长任务 → Perfetto 显示长任务覆盖卡顿窗口 → Profiler 指向具体方法 → 方法内部存在同步 IO。只有这些事实相互吻合,才适合进入修复阶段。
修复时优先切断主线程上的慢工作
修复方案取决于根因,而不是固定套用“加线程”。如果主线程同步访问数据库,应把可异步化的读取移出主线程,并让 UI 只处理已经准备好的结果;如果是锁竞争,应缩短持锁范围;如果是频繁对象分配导致抖动,则应减少热路径中的临时对象。
修复后先不要扩大改动面。尽量保持同一页面、同一数据量、同一设备和同一操作步骤,只改变导致故障的实现,这样回归结果才具有可比性。
用同一指标完成回归验证
回归至少回答三件事:卡顿是否消失、用户动作是否仍然正确、是否引入新的资源问题。重新执行原始复现步骤,并再次采集关键时间窗口。
可以把验证结果记录为简单表格:
| 指标 | 修复前 | 修复后 |
|---|---|---|
| 复现步骤 | 同一操作 | 同一操作 |
| 卡顿表现 | 明显停顿 | 无明显停顿 |
| 主线程长任务 | 存在 | 显著缩短或消失 |
| 关键方法耗时 | 高 | 明显下降 |
| 功能结果 | 正常或异常 | 应保持正常 |
最终形成一条闭环证据:现象可复现,数据能定位,代码能解释,修复可验证。这样一次卡顿故障才算真正完成,而不是仅仅“感觉不卡了”。