1. 从一次真实的 OOM 崩溃说起Android 内存溢出Out Of Memory在 Logcat 里通常长这样java.lang.OutOfMemoryError: Failed to allocate a 12345678 byte allocation with 4194304 free bytes或者更经典的bitmap size exceeds VM budget。它和普通崩溃最大的区别是——堆栈往往指向分配内存的那一行而不是真正泄漏的那一行。也就是说你看到的报错位置可能只是压垮骆驼的最后一根稻草。这篇内容适合两类人一类是刚接手一个跑一会儿就闪退的 Android 项目想快速定位是谁在吃内存另一类是已经会用 LeakCanary但想把排查链路和团队协作工具串起来让复现、验证、记录形成闭环。我会按「Logcat 过滤 → 内存快照 → 泄漏场景 → 复现验证 → 工具配置」的顺序走一遍中间给出可以直接复制的命令和配置片段。需要先明确一个前提OOM 排查的核心不是「找到报错行」而是「找到持有链」。Android 的 Dalvik/ART 在分配失败时抛出 OOM但对象为什么没被回收要靠引用链分析。所以下面的步骤会围绕「谁引用了谁」展开而不是只盯着报错堆栈。2. TaoToken 前置统一 Key 与 settings.json 骨架在进入具体排查之前先说一下工具侧的准备。我习惯把模型调用、代码补全、日志分析这类能力统一到一个 Key 上管理避免每个工具各配一套、换环境就失效。TaoToken 的 API 地址是https://taotoken.net/api官网入口在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end控制台和 Key 管理在https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite。如果你用的是支持settings.json的编辑器或 CLI 工具可以按下面的骨架配置。注意baseUrl不要带多余路径Key 用环境变量注入更安全{ ai: { provider: taotoken, baseUrl: https://taotoken.net/api, apiKey: ${TAOTOKEN_API_KEY}, model: claude-sonnet-4-20250514, timeoutMs: 60000 }, logging: { level: info, captureOomStack: true } }对应的环境变量在 macOS/Linux 下这样设置export TAOTOKEN_API_KEYsk-你的KeyWindows PowerShell$env:TAOTOKEN_API_KEYsk-你的KeyKey 的创建入口在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite。接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。这一步的意义在于后面你用工具去分析堆快照、生成排查脚本时不用再为每个环节单独配一套凭证。注意settings.json里不要硬编码明文 Key尤其是要提交到 Git 的仓库。用${VAR}占位CI 里再注入。3. 可复制配置Logcat 过滤与内存快照抓取3.1 Logcat 过滤命令OOM 的日志量很大直接adb logcat会刷屏。先按 tag 和关键字过滤adb logcat -v threadtime | grep -E OutOfMemoryError|bitmap size exceeds|GC_|dalvikvm|art更精确一点只看当前进程的崩溃adb logcat -v threadtime --pid$(adb shell pidof com.example.app) | grep -i outofmemory如果想抓完整堆栈并落盘用-d导出后分析adb logcat -d -v threadtime oom_full.log grep -n -A 30 OutOfMemoryError oom_full.log-A 30是为了把Caused by后面的引用链一起带出来。很多 OOM 的真正线索在Caused by的第二、三层而不是第一行。3.2 抓取内存快照HPROF在 OOM 发生前后抓堆快照是定位持有链的关键。先让应用进入可能泄漏的页面然后触发 GC 并 dumpadb shell am dumpheap com.example.app /data/local/tmp/app.hprof adb pull /data/local/tmp/app.hprof ./app.hprof如果要在代码里主动触发可以在Application里加一个调试入口if (BuildConfig.DEBUG) { Debug.dumpHprofData(cacheDir.resolve(manual.hprof).absolutePath) }拿到.hprof后用 Android Studio 的 Profiler 打开或者用hprof-conv转换后交给 MAT 分析。重点看Dominator Tree里占用最大的对象以及它的Path to GC Roots。3.3 LeakCanary 接入片段LeakCanary 能自动在 Activity/Fragment 销毁后检测泄漏。在build.gradle里加依赖dependencies { debugImplementation com.squareup.leakcanary:leakcanary-android:2.14 }2.x 版本不需要在Application里手动初始化只要依赖是debugImplementation启动后会自动安装。如果你要自定义可以在Application里这样写class MyApp : Application() { override fun onCreate() { super.onCreate() if (BuildConfig.DEBUG) { LeakCanary.config LeakCanary.config.copy( retainedVisibleThreshold 3, dumpHeap true ) } } }retainedVisibleThreshold 3表示对象被持有超过 3 次 GC 仍未被回收才判定为泄漏能减少误报。跑起来后泄漏会在通知栏弹出点进去能看到完整的引用链。4. 验证请求与成功结果配置好之后怎么确认链路是通的分两步验证。第一步验证模型侧 Key 可用。用 curl 发一个最小请求curl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: $TAOTOKEN_API_KEY \ -H anthropic-version: 2023-06-01 \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: ping}] }返回里能看到content字段和usage说明 Key 和网络都正常。如果返回 401检查 Key 是否带上了sk-前缀返回 404检查baseUrl是否多写了/v1。第二步验证 OOM 复现。我试过用一个简单的 Bitmap 循环来复现val list mutableListOfBitmap() repeat(200) { list.add(BitmapFactory.decodeResource(resources, R.drawable.large_photo)) }跑起来后 Logcat 会出现OutOfMemoryError同时 LeakCanary 如果检测到 Activity 泄漏会在通知里给出引用链。成功的结果是Logcat 有明确堆栈、HPROF 能抓到、LeakCanary 有引用链三者能对上。提示复现时把large_photo换成一张 2000x2000 以上的图小图不容易触发。5. 本篇常见错排查5.1 Logcat 里只有 OOM 没有堆栈有时候只看到OutOfMemoryError一行没有Caused by。这通常是因为日志被截断或者崩溃发生在 native 层。先确认adb logcat的 buffer 够大adb logcat -G 16M然后重新抓一次。如果是 native OOM需要看tombstone文件路径在/data/tombstones/。5.2 HPROF 抓下来打不开am dumpheap生成的.hprof是 Dalvik 格式Android Studio 能直接读但 MAT 需要先转换hprof-conv app.hprof app-converted.hprofhprof-conv在 Android SDK 的platform-tools目录下。转换后再用 MAT 打开否则会报格式错误。5.3 LeakCanary 不报泄漏先确认依赖是debugImplementation而不是implementationrelease 包不会启用。其次确认BuildConfig.DEBUG为 true。如果还是不报可能是泄漏对象被retainedVisibleThreshold过滤掉了把它调小到 1 再试。5.4 Context 泄漏的典型场景回到 excerpt 里提到的例子static Drawable持有TextViewTextView持有Activity。这种泄漏在方向切换时最明显。修复方式是不要用static持有 View 相关的 Drawable或者用Application的 Context 去加载资源。另外Activity 里如果有线程没停也会导致 Context 泄漏记得在onDestroy()里interrupt()或取消。5.5 数据库 Cursor 和流未关闭这类问题在 OOM 里占比不低。Cursor 用完要close()InputStream/OutputStream用 try-with-resources 或use {}FileInputStream(file).use { input - // 读取逻辑 }Kotlin 的use会自动关闭比手动finally更不容易漏。6. 把排查链路固定下来排查 OOM 最怕的是「这次修了下次换个页面又崩」。我的做法是把上面几步固化成团队流程Logcat 过滤命令写进脚本HPROF 抓取做成调试菜单LeakCanary 常驻 debug 包。这样每次 OOM 都能按同一套路径走而不是靠记忆。如果你想把模型分析也接进这条链路比如让工具自动读 HPROF 摘要、生成引用链解释可以用 TaoToken 的模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite先验证模型输出是否符合预期。长期做 Android 编码和 Agent 辅助的可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite把 Key 和额度统一管理。Claude Code 相关的接入在https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite。最后留一个我踩过的坑抓 HPROF 时不要在主线程做否则容易二次 OOM。放到子线程或者用Debug.dumpHprofData的异步版本抓完立刻 pull 出来别留在设备上占空间。