第 2 章　泄漏数据采集工具全景

2.1　现象识别：什么时候该采集？

Flow 订阅泄漏往往没有显式异常，但以下几种“红灯”信号必须触发采集动作：

• 多次返回页面后，空闲内存持续下降（用 dumpsys meminfo 或 adb shell top 观测）
• GC 日志频繁出现 ConcurrentStarvation 或 Allocation failure
• LeakCanary 桌面通知弹出（即使没弹出，也应周期性巡检）
• 使用 Android Studio Profiler 观察到对象计数不减反增

出现上述任意一种，立即进入数据采集流程。

2.2　数据采集：四种工具实战用法

2.2.1　Android Studio Profiler 实时采集

• 操作步骤：在 Android Studio 中连接设备 → 点击 Profiler 面板 → 选择 Memory → 点击 Record。
• 关键参数：勾选 Record Java/Kotlin allocations；配合 Record native allocations 可排查 JNI 泄漏。
• 数据输出：录制自动生成对象堆快照，可在 Heap Dump 标签页中按类名搜索，查看实例数量和引用关系。
• Flow 泄漏线索：搜索 Flow、Continuation、AbstractCoroutine 等类名，看是否有残留实例。

2.2.2　LeakCanary 自动化采集

在 build.gradle 中添加依赖后，LeakCanary 会自动监控 Activity、Fragment、ViewModel 以及自定义 Watcher 注册的对象。当它检测到某个对象在 lifecycle 结束后仍未被 GC，就会生成一个 hprof 快照并解析出引用链。

// Kotlin 示例：注册自定义对象监视
LeakCanary.config = LeakCanary.config.copy(
    watcherFactories = listOf(
        SupportFragmentWatcherFactory(application),
        ActivityWatcherFactory(application),
        object : ObjectWatcherFactory {
            override fun create(application: Application): ObjectWatcher {
                return ObjectWatcher(application, name = "FlowSubscriber", 
                    reachabilityInspectors = listOf(FlowSubscriberReachabilityInspector()))
            }
        }
    )
)

当泄漏发生时，Logcat 会打印类似以下信息：

====================================
HEAP ANALYSIS RESULT
====================================
1 RETAINED OBJECTS
* com.example.app.MainViewModel (0x12c)
  - referencing FlowCollector (0x234)
  - referencing ContinuationImpl (0x345)
  - referencing JobSupport (0x456)
  - Root: thread main, system class

2.2.3　dumpsys meminfo 快速水位采集

适合在 CI 或线上容灾场景获取整体内存状态。用法：

adb shell dumpsys meminfo com.example.app -d

关键输出行及其含义：

App Summary
                       Pss(Total)      Private  Dirty     Private  Clean     ...
Native Heap             12345           10000    0                ...
Java Heap               23456           20000    0                ...
... 
Total PSS by OOM adjustment:           ...
  Foreground:       35791 kB
  ...

• Pss(Total)：进程占用的物理内存比例值，越线意味着可疑。
• Java Heap 区域的 Private Dirty 持续增长通常是 Java 泄漏（包括 Flow 泄漏对象）的征兆。
• 多次执行并对比 Total PSS，若每次操作后回不到初始值，说明存在泄漏。

2.2.4　hprof 文件深度采集

当 Profiler 或 LeakCanary 给出快照后，你可以导出 .hprof 文件进行离线分析。手动导出命令：

adb shell am dumpheap com.example.app /data/local/tmp/dump.hprof
adb pull /data/local/tmp/dump.hprof ~/analysis/

然后用 MAT（Memory Analyzer Tool）或 Perfetto UI 打开。在 MAT 中：

1. 选择 Histogram，搜索 Flow、Continuation。
2. 右键任意实例 → Merge Shortest Paths to GC Roots → 排除软/弱/虚引用。
3. 查看导致泄漏的引用链，确认是否由 Flow 的 collect 未取消导致。

2.3　原因定位：工具输出配合判断

四种工具的输出各有侧重，但判断泄漏原因时建议遵循以下规则：

• dumpsys meminfo 只用作“是不是泄漏”的开关，无法定位哪个对象。
• Profiler / hprof 可找到残留对象和引用链，但需要人工筛选 Flow 相关类。
• LeakCanary 直接给出 retained object 和最短 GC 路径，几乎不需要二次分析。

2.4　复测：验证采集是否有效

每次采集后，必须执行一次“复现 → 离开 → 再次采集”的闭环，确认泄漏量是否稳定：

1. 执行完整泄漏触发场景（如反复进入/退出 Fragment 10 次）。
2. 使用 dumpsys meminfo 记录 Java Heap PSS 基线。
3. 等待 5 秒钟（让 GC 运行），再用 Profiler 捕获堆快照。
4. 对比 10 次前后的对象计数，若 FlowCollector 实例数不等于已销毁实例数，则采集成功，泄漏已捕获。

2.5　预防与自动化策略

• CI 门禁：在自动化测试后添加 dumpsys meminfo 比较脚本，超标即 fail。
• LeakCanary 灰度：在内部版本始终开启，重点监控新写的 Flow 页面。
• hprof 定期导出：通过 am dumpheap 定时采集慢路径（见第 12 章），用于离线回归。