4. 堆转储采集：获取HPROF文件、分场景快照
数据采集是问题排查型课程中“证据固定”的核心环节。上一章我们确认了内存泄漏的现象并初步圈定了可疑组件为 LifecycleRegistry，本章将聚焦如何精准、及时地捕获堆转储（HPROF）文件，为后续的原因定位提供高质量的“案发现场快照”。
4.1 堆转储采集的故障树分析
当应用出现内存泄漏时，任何一次 GC 都可能将“犯罪证据”临时回收，导致 HPROF 快照无效。因此，采集时机必须与泄漏现象紧密耦合。下面是一棵快速判断的故障树：
故障树核心判断规则：
- 根节点：应用已稳定复现 GC ROOT 无法释放 LifecycleRegistry 对象（通过上一章 Dumpsys meminfo 确认）。
- 分支 A：手动触发 GC 后，仍能观察到 LifecycleRegistry 实例 → 立即采集。
- 分支 B：手动触发 GC 后，实例消失 → 泄漏对象已被 GC 回收，当前快照无效 → 重新触发泄漏路径（例如：在 Activity 中反复横跳后立刻采集）。
- 分支 C：使用分场景快照策略（见 4.3 节）→ 优先采集“峰值压力”场景下的 HPROF。
4.2 三种主流采集工具对比
| 工具 | 采集方式 | 对应用性能影响 | 适用阶段 |
|---|---|---|---|
| Android Studio Profiler | 图形化点击“Dump Java Heap” | 中度（应用会短暂挂起） | 开发调试 |
| adb shell am dumpheap | 命令行远程触发 | 低（可后台触发） | 自动化测试 / CI |
| Perfetto 原生捕获 | 结合 trace 同时捕获堆与时间线 | 较高（需配置额外 buffer） | 性能问题联合分析 |
专家建议： 在排查 LifecycleRegistry 泄漏时，首选 adb shell am dumpheap 方式，因为它可以精确控制触发时机，并且不会因为 IDE 的附加调试而引入额外的引用链干扰。
4.3 分场景快照策略
不要只采集一次堆转储。LifecycleRegistry 的泄漏可能在不同生命周期阶段表现不同。我们应建立一套“分场景快照”的采集矩阵：
- 基线快照：
- 场景：应用启动后，未进入可疑 Activity。
- 目的：建立正常状态下的 LifecycleRegistry 实例数基线。
- 压力快照：
- 场景：反复进入/退出可疑 Activity 至少 5 次后，立刻触发 GC 并采集。
- 目的：捕获最大泄漏压力下的实例堆积。
- 关键操作快照：
- 场景：在 Activity 的 onStop() 或 onDestroy() 回调中，直接通过 Thread.sleep(2000) 等待几秒后强制采集。
- 目的：确认 LifecycleRegistry 是否在生命周期回调中仍持有外部引用。
- 确认快照：
- 场景：修复后再执行一次与“压力快照”完全相同的操作序列后采集。
- 目的：用于后续复测对比（详见第 7 章）。
4.4 HPROF 采集命令行实战
以下命令适用于大部分 Android 7.0+ 设备，无需 root 权限：
# 1. 获取目标应用进程 PID
adb shell ps | grep com.example.leakapp
# 2. 强制触发一次 GC（可选，用于观察是否可回收）
adb shell am force-stop com.example.leakapp
# 3. 重新启动应用并复现泄漏场景后，采集堆转储
adb shell am dumpheap com.example.leakapp /data/local/tmp/heap_dump.hprof
# 4. 将 HPROF 文件拉取到本地（注意：HPROF 文件较大，拉取可能耗时）
adb pull /data/local/tmp/heap_dump.hprof ./leak_dumps/
# 5. 将标准 Android HPROF 转换为 MAT 可识别的标准格式（若使用 MAT）
hprof-conv heap_dump.hprof heap_dump_standard.hprof
避坑指南：
- 不要在应用后台时执行 dumpheap，此时进程可能已被冻结，导致堆转储不完整。
- HPROF 文件在设备上可能占用数百 MB 空间，采集前确认 /data/local/tmp 有足够空间。
- 如果拉取失败，尝试重启 adb 服务：adb kill-server ; adb start-server。
4.5 堆转储采集验证矩阵
采集完成后，立即在本地执行快速验证，确保 HPROF 文件可用于后续分析：
| 验证项 | 判断规则 | 操作 |
|---|---|---|
| 文件完整性 | 文件大小 > 50MB（视应用内存而定） | ls -lh heap_dump_standard.hprof |
| 时间戳匹配 | 文件创建时间与测试场景执行时间一致（误差 < 30 秒） | stat heap_dump.hprof | grep Modify |
| 格式可读性 | 使用 hprof-conv 转换成功，无 error 输出 | 检查转换返回值（$?）是否为 0 |
4.6 本章排查流程图：堆转储采集决策
4.7 实战贴士：高版本 Android 的 HPROF 兼容性
在 Android 11 及以上版本，Google 对 HPROF 的访问权限进行了收紧。如果你的应用目标 API >= 30，需要注意：
- adb shell am dumpheap 仍然可用，但要求应用为 debuggable 或设备已 root。
- 如果使用 Android Studio Profiler，确保 Gradle 插件版本 >= 4.2 且 AGP 配置中
debuggable true。 - 对于非 debuggable 的发布版应用，建议在生产环境集成第三方的内存快照 SDK（如 LeakCanary 3.x 的 heap dump 回调），由 SDK 自动管理采集时机。
本章核心交付物：
- 一份符合采集验证矩阵的 HPROF 文件（建议保存为：
Time_ActivityName_Fresh.hprof格式）。 - 一个“分场景快照采集记录表”，记录每次采集的触发场景、复现次数、文件大小。
- 为下一章“MAT 主导引用链分析”准备好高质量的原始数据。