必备调试工具链：adb命令、dumpsys、bugreport、logcat、systrace、perfetto

在SystemUI无障碍线程的调试与性能分析中，工具链的选择直接决定排查效率。本章将工具链作为问题排查的“眼睛”与“手术刀”，围绕现象识别、数据采集、原因定位、修复动作、复测验证、预防方案六个环节，逐一拆解每个工具的使用场景、关键参数及判断规则。

2.1 工具链总览与排查阶段映射

以下表格将六类工具映射到问题排查的完整生命周期，便于你在不同阶段快速选择正确的工具。

2.2 故障树：无障碍线程卡顿根因快速定位

以下故障树帮助你从“线程卡顿”这一顶层现象出发，通过工具链逐层剥离干扰项，直达根因。每个分支标注了应该使用的调试工具。

2.3 各工具的操作要点与判断规则

2.3.1 adb命令 —— 基础连接与控制

adb是调试的入口，必须熟练掌握以下高频变体。

# 查看设备连接
adb devices -l

# 实时过滤无障碍日志
adb logcat -s AccessibilityUtil AccessibilityBridge -v threadtime

# 强制生成trace（无需root）
adb shell atrace --async_start -z -b 16384 sched freq idle am

# 停止并导出trace文件
adb shell atrace --async_stop -z -o /data/local/tmp/trace_output.atrace
adb pull /data/local/tmp/trace_output.atrace .

2.3.2 dumpsys —— 线程与Binder状态快照

在ANR发生瞬间或卡顿时，立即执行以下命令捕获线程堆栈。

# 抓取主线程堆栈（ANR时）
adb shell dumpsys meminfo systemui | grep -i thread

# 查看AccessibilityManagerService状态
adb shell dumpsys accessibility

# 获取窗口焦点变化历史（判断焦点切换导致的阻塞）
adb shell dumpsys input -h

2.3.3 bugreport —— 全量系统快照

bugreport 适合事后离线分析，包含所有LOG、线程dump、进程状态、内核信息。生成时间较长（约1~2分钟），不要在用户现场直接等待。

adb bugreport bugreport_$(date +%Y%m%d_%H%M%S).zip

2.3.4 logcat —— 实时行为跟踪

对无障碍线程，需要调整日志缓冲区大小并过滤关键Tag。

# 增大日志缓冲区（避免早期日志被覆盖）
adb logcat -G 8M

# 带时间戳过滤无障碍Tag
adb logcat -v time -s AccessibilityUtil AccessibilityBridge AccessibilityNodeInfo

判断规则：

• 出现 W/AccessibilityUtil: performAction timeout → 操作超时，可能主线程阻塞
• 出现 E/AccessibilityBridge: Binder transaction failed → Binder线程耗尽或死锁
• 出现 I/SystemService: ANR in SystemUI (main) → 立即结合dumpsys抓取堆栈

2.3.5 systrace —— 短时精确跟踪（< 10秒）

systrace 适合诊断8ms以内瞬时卡顿。通过Chrome浏览器分析trace文件。

# 启动Trace，抓取sched、freq、am、binder_driver
python systrace.py -o trace.html sched freq am binder_driver -t 5

# 或者使用atrace替代（无需systrace.py）
adb shell atrace --async_start -z -b 8192 sched freq am binder_driver
sleep 5
adb shell atrace --async_stop -z -o /data/local/tmp/trace.html

2.3.6 perfetto —— 长周期与深度剖析

perfetto 是systrace的下一代，支持更长的采集时间（30秒~5分钟）和更多数据源（内存、CPU、Ftrace、Heapprof）。性能开销远低于bugreport，适合生产环境点检。

# 使用文本配置，采集5秒trace
adb shell perfetto -c - --txt <

# 1. 清除旧日志
adb logcat -c

# 2. 复现场景（例如快速滑动无障碍列表）
adb shell input swipe 200 500 400 500 10

# 3. 采集5秒systrace
adb shell atrace --async_start -z -b 8192 sched freq am binder_driver
sleep 5
adb shell atrace --async_stop -z -o /data/local/tmp/trace_fix.atrace

# 4. 拉取trace并对比基线——无障碍线程连续运行时间占比应大于80%

# 简单的告警脚本示例（bash）
#!/system/bin/sh
# 检查bugreport中Accessibility相关ANR次数
ANR_COUNT=$(zgrep -c "ANR in .*Accessibility" bugreport_*.zip)
if [ $ANR_COUNT -gt 3 ]; then
  echo "WARNING: Accessibility ANR frequency too high: $ANR_COUNT" | tee /dev/kmsg
fi