第1章 识别SurfaceFlinger合成帧率异常的典型现象

1.1 异常现象描述

SurfaceFlinger 合成帧率异常通常表现为以下五类典型现象，它们可能单独出现，也可能组合爆发。准确识别这些现象是后续数据采集与根因定位的前提。

现象类别	典型表现	直观感受	初步判断
掉帧 (Jank)	合成完成但实际显示的帧数与预期帧数不符	画面跳跃、卡顿	掉帧计数器 > 0
卡顿 (Stutter)	连续几帧合成时间超过 vsync 周期	操作响应延迟、滑动不跟手	帧耗时 > 16.67ms
掉帧计数器暴涨	numFramesDropped 数值在短时间内急剧增长	系统动画异常频繁卡顿	累计计数跳变 > 100
图层合成间隔不均	相邻两帧提交时间差忽大忽小	视觉上忽快忽慢	帧间隔方差 > 2ms
VSync 抖动	硬件 vsync 信号周期不稳定	整体画面微颤、闪烁	vsync 偏移 > 0.5ms

1.2 排查思路

采用“现象→数据→定位”逐层收敛的故障树方法。先通过用户反馈或自测捕捉到至少一个典型现象，然后利用对应的采集工具获取现场数据，再根据判断规则缩小范围，最后锁定根因。

1.3 关键判断规则

使用以下量化规则快速判定当前异常属于哪一类，避免凭感觉下结论。

• 掉帧规则：在 dumpsys SurfaceFlinger 输出中找到 numFramesDropped 字段，若当前值 - 历史值 > 0 则判定掉帧。
• 卡顿规则：通过 systrace 查看 doComposition 耗时，若连续2帧以上超过 vsync 周期（16.67ms@60Hz）即为卡顿。
• 计数器暴涨规则：取两次时间戳（间隔5秒）的 numFramesDropped 差值，若差值 > 100 则为暴涨。
• 间隔不均规则：计算 FrameAvailable 时间戳的差值，方差 > 2ms² 则判定间隔不均。
• VSync抖动规则：在 /sys/devices/virtual/graphics/fb0/vsync_event 中捕获vsync中断间隔，标准差值 > 0.5ms 则判定抖动。

1.4 采集方法

推荐使用以下标准采集流程，确保数据一致性：

1. 基础全局采集：执行 adb shell dumpsys SurfaceFlinger，保存完整输出。
2. 帧耗时采集：adb shell dumpsys gfxinfo|grep "draw\|process\|execute" 获取单帧各阶段耗时。
3. 连续跟踪采集：使用 systrace -b 16384 -a com.android.systemui gfx view am wm 抓取15秒 trace。
4. VSync原始数据采集（root设备）：adb shell cat /sys/devices/virtual/graphics/fb0/vsync_event 连续记录1000个样本。

# 示例：掉帧计数器两次采集对比
adb shell dumpsys SurfaceFlinger | grep "numFramesDropped" > before.txt
sleep 5
adb shell dumpsys SurfaceFlinger | grep "numFramesDropped" > after.txt
diff before after.txt

1.5 修复步骤

根据现象类型采取不同的初步修复动作（仅针对本章识别阶段，深度修复在后续章节展开）：

现象类型	初步修复动作
掉帧	检查图层合成策略，关闭非必要 GPU 图层回读；降低帧缓存大小
卡顿	优化渲染管线，减少 overdraw；升级 GPU 驱动或调低分辨率测试
计数器暴涨	检查 BufferQueue 是否丢帧；增大 HDR 合成缓存池
间隔不均	确认是否存在异步合成延迟；调整合成线程优先级
VSync抖动	检查 panel 驱动 vsync 配置；禁用非必要中断共享

1.6 复测要点

• 使用相同的数据采集命令，对比修复前后的 numFramesDropped 增长率。
• 运行基准场景（例如滑动联系人列表、Launcher 动画）超过30秒，观察卡顿次数。
• 重新计算 vsync 间隔方差，确保 < 0.3ms。
• 利用 systrace 抓取修复后 trace，确认合成线程未出现连续超时帧。

1.7 预防建议

1. 建立基线：每版系统发布前，在标准机型上记录掉帧计数、帧耗时、vsync 抖动基线值。
2. 代码审查拦截：所有涉及 SurfaceFlinger 合成策略、BufferQueue 参数修改的提交必须附带 systrace 对比结果。
3. 灰度/线上监控：通过 stability_monitor 或自有 crash 系统采集 numFramesDropped 的值与增量，配置告警阈值（如每5秒增长>200）。
4. 硬件兼容测试：不同面板的 vsync 行为差异可能很大，建议在主要驱动供应商（三星、京东方、天马）的每款面板上运行 vsync 测试用例。