2. 导航栈基础概念回顾：调用栈与堆栈深度剖析

2.1 现象识别：混淆堆栈 vs 原始堆栈

在ANR问题现场，开发者最常遇到的第一个障碍是难以直接阅读的堆栈信息。当应用发布为Release版本并开启混淆（ProGuard/R8）后，`/data/anr/traces.txt` 中的堆栈往往呈现为类似以下形态：

at o.someMethod(:12)
at a.notify(:23)
at main activity.onCreate(:8)

这种“混淆堆栈”（Obfuscated Stack Trace）将包名、类名、方法名替换为无意义的单字母，将行号映射为混淆后的偏移量。而“原始堆栈”（Deobfuscated Stack Trace）则保留了可读的全限定名与准确行号。两者的区分是排查工作的起点。

2.2 数据采集：获取原始与混淆堆栈的两种路径

2.3 原因定位：调用栈与堆栈的核心差异

在ANR分析中，调用栈（Call Stack）与堆栈（Stack Trace）经常被混用，但两者有本质区别：

• 调用栈（Call Stack / Stack Frame Chain）：是JVM/ART虚拟机运行时的数据结构，记录了某个线程当前执行点开始向上回溯到线程入口的所有方法帧（Frame）。每个帧对应一个还未返回的方法调用。主线程的调用栈是判断UI线程是否阻塞的直接证据。
• 堆栈（Stack Trace / Stack Dump）：是调用栈的文本快照。当ANR发生时，系统会一次性dump所有线程（主线程+子线程）的调用栈，并附加CPU占用、锁信息等环境数据，形成我们看到的traces.txt内容。

2.4 修复动作：从方法帧与行号还原阻塞点

一个标准的方法帧（Frame）包含以下关键字段，我们可以通过拆解这些字段来定位阻塞代码：

at com.example.myapp.MainActivity.onClick(MainActivity.java:45)
 ^           ^                     ^                   ^
 |           |                     |                   └── 字节码行号（源码行号映射）
 |           |                     └── 方法名 + 参数类型描述符（已脱敏）
 |           └── 包名.类名（全限定名）
 └── 调用类型标记（at表示栈顶帧）

排除逻辑：

1. 如果行号显示在 Handler.dispatchMessage 或 View.onTouchEvent 等系统框架方法上，说明阻塞发生在框架层回调，需继续向下看下一帧或分析该帧耗时。
2. 如果行号对应业务代码中的 Thread.sleep()、wait()、InputStream.read() 等主动阻塞API，排查方向应为：为什么在该位置触发长时间等待？
3. 如果行号对应 BitmapFactory.decodeStream、SQLiteDatabase.query 等IO或数据库操作，则应关注文件读取或数据库查询的执行时间。

2.5 复测：符号化与混淆映射验证流程

完成初步定位后，必须对线上混淆堆栈进行符号化还原，以确认推测的正确性。符号化工具依赖 mapping.txt 将混淆后的类名、方法名、行号还原为原始状态：

# 使用 retrace.sh (ProGuard) 或 ReTrace (R8)
java -jar /sdk/tools/proguard/lib/retrace.jar mapping.txt obfuscated_trace.txt

复测清单：

• 确认 mapping.txt 版本与APK版本一致。
• 在本地或CI环境中执行符号化命令，输出与原始堆栈对比是否匹配。
• 如用于 firebase 等平台，上传 mapping 文件并验证该版本 ANR 堆栈是否已成功还原。

2.6 预防：建立可追溯的导航栈体系

为了避免在ANR排查初期就陷入“堆栈不可读”的泥潭，需在工程层面做好以下预防措施：

• 映射文件版本管理：将 mapping.txt 纳入 Git LFS 或对象存储（OSS），命名规则 mapping-{versionCode}-{versionName}.txt。
• 堆栈采集标准化：在 ANRWatchDog 或自定义监控中，同时采集原始堆栈（debuggable=true时）和混淆堆栈，并保存 versionCode。
• 定期回归测试：在性能测试中，对主线程添加 Looper.getMainLooper().setMessageLogging() 监控，若单次dispatch耗时超过200ms则记录当前线程的调用栈快照。