卡顿监控工具链（Perfetto、Systrace、BlockCanary 与 JankStats）

回到总览：性能、测试、排障
相关模块：Android ANR 触发机制、排障定位与防范 · Android View 绘制流程、Choreographer 与 VSync 帧同步

一句话定义

卡顿监控工具链是指通过系统级跟踪（Perfetto / Systrace）、主线程 MessageQueue 消息耗时拦截（BlockCanary）以及官方 JankStats 库，定位并治理因主线程耗时、布局过深、GC STW 或 GPU 合成延迟导致单帧渲染超时（> 16.6ms / 8.3ms）引发界面丢帧与不流畅体验的技术体系。

代码索引

对应 Lab：jank-monitoring-demo · JankMonitoringDemoActivity.kt

为什么需要

为什么仅靠 Choreographer.postFrameCallback 计算 FPS 无法精准定位导致卡顿的具体函数？
- 一句话答：postFrameCallback 只能告诉你“发生了丢帧”这个结果，但无法捕获引发丢帧的具体堆栈；必须配合 Perfetto 的 Trace 区块或 BlockCanary 截获的主线程 Message 执行堆栈，才能精确定位到具体的耗时函数。
为什么 10 年 Android 工程师必须掌握 Perfetto 全系统跟踪？
- 一句话答：现代 Android 系统（10.0+）全面转向 Perfetto，它能够将 CPU 核心频率、App 主线程切频、Binder 跨进程调用、Choreographer VSync 脉冲以及 GPU 渲染线程打包展示在一张统一的时间线上，是解决复杂丢帧问题的最终判官。

底层机制

1. BlockCanary 原理：主线程 Handler `Printer` 机制

对应 Lab：jank-monitoring-demo

Android Looper.loop() 在处理每一条 Message 的前后，都会打印日志：

java

// Looper.java 源码机制
public static void loop() {
    for (;;) {
        Message msg = queue.next();
        // 1. 消息分发前打印日志
        final Printer logging = me.mLogging;
        if (logging != null) {
            logging.println(">>>>> Dispatching to " + msg.target + " " + msg.callback);
        }

        msg.target.dispatchMessage(msg); // 真正执行消息!

        // 2. 消息分发后打印日志
        if (logging != null) {
            logging.println("<<<<< Finished to " + msg.target + " " + msg.callback);
        }
    }
}

BlockCanary 核心逻辑：通过 Looper.getMainLooper().setMessageLogging(printer) 注入自定义的 Printer：

捕获 >>>>> 字符串，记录起始时间 $T_{1}$ ，并启动后台线程进行连续的堆栈采样。
捕获 <<<<< 字符串，记录结束时间 $T_{2}$ 。
计算耗时 $Δ T = T_{2} - T_{1}$ 。若 $Δ T > 200 m s$ ，判定发生卡顿，将采样到的主线程堆栈打包导出为卡顿报告！

2. Perfetto / Systrace 可视化跟踪原理

利用 Linux 内核 ftrace 机制，在用户态通过 Trace.beginSection(String sectionName) 和 Trace.endSection() 写入内核缓冲区。

text

[App 线程] ─── Trace.beginSection("Measure") ───► [Kernel ftrace ring buffer]
                                                           │
                                                           ▼ (adb pull / Perfetto UI)
                                            [https://ui.perfetto.dev 可视化时间轴]

展现的核心指标：

SF (SurfaceFlinger) 轨迹：显示系统合成与显示屏刷新的物理时间线。
App 进程主线程轨迹：显示 Choreographer#doFrame 执行过程、input / animation / traversal 的细化耗时。
CPU Sched 轨迹：显示主线程运行在哪个 CPU 核心，是否发生了频繁的上下文切换（Context Switch）。

Android / Flutter / Web / Backend 对照

工具/机制	Android 原生	Flutter 框架	Web 浏览器
全链路 Trace	Perfetto / Systrace	Flutter DevTools Timeline	Chrome Performance Tab
主线程卡顿拦截	BlockCanary (Handler Printer)	`debugPrintRebuildDirtyWidgets`	Long Tasks API (`PerformanceObserver`)
官方 Jank 统计	AndroidX JankStats	`PerformanceOverlay` (UI/Raster 柱状图)	Web Vitals (INP / CLS / LCP)

常见场景

1. 使用 AndroidX JankStats 监测生产环境丢帧

java

// 在 Activity 中初始化 JankStats 监听
JankStats jankStats = JankStats.createAndTrack(getWindow(), new JankStats.OnFrameListener() {
    @Override
    public void onFrame(@NonNull FrameData frameData) {
        if (frameData.isJank()) {
            // 这帧渲染超时了！(例如耗时 > 16.6ms)
            long durationNanos = frameData.getFrameDurationUiNanos();
            Log.w("JankStats", "检测到丢帧卡顿！UI 耗时(ms): " + (durationNanos / 1_000_000));
        }
    }
});

常见误配、事故后果与排障

1. 事故：BlockCanary 导致线上环境 CPU 占用过高

误配原因：将 BlockCanary 或 Profiler 的“高频采样”（如每 5ms dump 一次堆栈）发布到了线上 Release 环境。
后果：频繁挂起线程 Dump 堆栈本身造成了巨大的 CPU 损耗，导致应用原本不卡顿却因为监控工具自身变卡（观察者效应）。
排障与修法：BlockCanary 仅用于 Debug/Beta 内部测试环境；线上环境推荐使用 JankStats 或系统 FrameMetrics API 采集卡顿率统计。

与相近概念对比

工具/方法	部署环境	能否捕获卡顿堆栈	侧重点
Perfetto	开发/测试 (adb / UI)	是 (极其精准的时间线)	深入内核、物理帧、CPU 切频分析
BlockCanary	测试/内测 (Debug包)	是 (Handler 级别的调用栈)	定位单个 Message 阻塞堆栈
JankStats	生产环境 (Release包)	否 (仅捕获耗时数值与状态)	统计线上丢帧率、Jank 发生的百分比

对应实验

Lab	说明	源码
jank-monitoring-demo	Choreographer FPS 统计 + Looper Printer 主线程卡顿检测（BlockCanary 思路），可触发模拟卡顿	JankMonitoringDemoActivity.kt

复习检查题

BlockCanary 是如何利用 Looper 的 Printer 机制捕获主线程卡顿的？
答：Android 的 Looper.loop() 在派发每一条消息前后，如果设置了 Printer，都会调用其 println() 输出日志。BlockCanary 通过 Looper.getMainLooper().setMessageLogging() 注入自定义 Printer，在消息开始派发 >>>>> 时记录时间并开启后台堆栈采样，在消息结束 <<<<< 时计算耗时。如果耗时超过设定的阈值（如 200ms），则将这段时间采样的堆栈聚合为卡顿报告。
在 Perfetto 的可视化 Trace 图谱中，丢帧通常在时间线上表现为什么现象？
答：在 Perfetto UI 中，丢帧通常表现为 Choreographer 的 doFrame 轨迹块跨度过长，超出了当前设备 VSync 刷新间隔（例如 60Hz 设备的 16.6ms 或 120Hz 设备的 8.3ms）。同时，SurfaceFlinger 的 BufferQueue 轨迹会出现红色的 Jank 标记，提示上屏渲染延迟。

速记

BlockCanary：注入 Looper Printer 算时间，> 200ms 输出卡顿堆栈。
Perfetto：全系统 ftrace 终极追踪，结合 CPU/VSync/主线程开诊断。
JankStats：线上丢帧率轻量统计，Release 环境必备。

卡顿监控工具链（Perfetto、Systrace、BlockCanary 与 JankStats） ​

一句话定义 ​

代码索引 ​

为什么需要 ​

底层机制 ​

1. BlockCanary 原理：主线程 Handler Printer 机制 ​

2. Perfetto / Systrace 可视化跟踪原理 ​

Android / Flutter / Web / Backend 对照 ​

常见场景 ​

1. 使用 AndroidX JankStats 监测生产环境丢帧 ​

常见误配、事故后果与排障 ​

1. 事故：BlockCanary 导致线上环境 CPU 占用过高 ​

与相近概念对比 ​

对应实验 ​

复习检查题 ​

速记 ​