1. 从一次线上 OOM 说起Android 内存泄漏排查链路怎么搭Android 内存泄漏这个词做过几年移动端的同学应该都不陌生。它不像崩溃那样直接给你一个红彤彤的堆栈而是像温水煮青蛙——页面越开越卡滑动越来越顿最后在某一次图片加载或者列表刷新时直接抛出一个java.lang.OutOfMemoryError进程被系统干掉。用户看到的是闪退你看到的是崩溃平台上一堆没有明确指向的 OOM 日志。我这次遇到的场景比较典型一个内容流页面用户反复进出详情页、切换 Tab、下拉刷新大概操作二三十次之后内存曲线就一路往上不回头最终 OOM。用 Android Studio Profiler 抓了几次堆发现 Activity 实例数量一直在涨明显是有对象被长期持有没释放。顺着引用链往下查问题出在网络层——一个静态的请求管理器持有了 Activity 的 Context而这个管理器又跟 Base URL、鉴权 Key 的配置耦合在一起配置改一次就重新初始化一次旧的实例没被回收。这篇文章就围绕这条排查链路展开先讲清楚内存泄漏在 OOM 之前是怎么一步步积累的再以 Base URL 配置为切入点演示怎么把网络层统一改到 TaoToken 的 Key/API 通道然后用 Profiler 和 LeakCanary 复现、定位、验证泄漏点。整个过程我会给出可复制的配置片段、抓取步骤和引用链验证动作你跟着做就能在自己项目里跑一遍。适合谁看如果你正在被 OOM 困扰或者想系统学一遍 Android 内存泄漏的排查方法又或者你刚好在整理网络层的统一配置这篇都能对上。核心检索词就三个Android 内存泄漏、OOM 排查、Base URL 配置。下面从问题本身开始拆。2. 内存泄漏是怎么一步步把 App 推向 OOM 的先说清楚一个概念内存泄漏不是「内存不够用」而是「该回收的对象回收不掉」。Android 每个进程能用的堆内存是有限的具体上限跟设备、是否 largeHeap 有关一般几十到几百 MB。当泄漏的对象越积越多可用堆越来越小某一次稍微大点的分配比如加载一张大图、解析一个大 JSON就会触发 OOM。泄漏的根源绝大多数是「长生命周期对象持有了短生命周期对象」。最典型的就是静态变量、单例、线程、Handler、监听器这些活得比 Activity 长的东西间接持有了 Activity 或它的 View。Activity 明明已经onDestroy了但因为还被引用着GC 回收不了它里面所有的 View、Bitmap、Context 全都跟着一起泄漏。我这次的问题就属于这一类。网络层有个单例管理器构造时传入了 Activity 的 Context然后把它存成了成员变量。每次配置变更比如切换环境、改 Base URL都会重新 new 一个管理器但旧的没被置空静态引用还指着它它又指着 Activity于是 Activity 泄漏。用户每进出一次页面就泄漏一个 Activity几十次之后内存自然扛不住。常见的泄漏点还有几类你可以对照自查资源对象没关闭比如 Cursor、File、InputStream。这类对象不光占 JVM 堆内存还占堆外内存不 close 光置 null 是没用的。数据库查询完 Cursor 一定要在 finally 里 close。Adapter 的 getView 没用 convertView。ListView 滑动时不断创建新 View旧的虽然会被回收但频繁创建本身就会让内存抖动配合其他泄漏更容易触发 OOM。Bitmap 用完没 recycle。虽然现在 GC 能管大部分情况但大图手动 recycle 仍然是个好习惯尤其是图片列表场景。Context 用错。长期存活的对象一定要用 ApplicationContext别用 Activity 的。注册没反注册。广播、传感器、电话状态监听register 了就要在合适时机 unregister。集合只加不减。静态集合往里塞对象用完不清理越积越大。这些点单独看都不难难的是「怎么知道当前这次 OOM 到底是哪个点引起的」。这就需要工具和链路。而链路的第一步往往是从网络层配置这种「看起来跟内存无关」的地方开始因为配置管理最容易写出静态持有。3. 把网络层 Base URL 统一改到 TaoToken 通道为什么内存泄漏排查要扯到 Base URL因为很多项目的网络层是这么写的一个ApiManager单例构造时读配置、拼 Base URL、存 Key然后被静态持有。配置一改就重建旧实例泄漏。要根治除了修引用更稳的做法是把「配置」和「请求」解耦——Base URL、Key、Model ID 这些统一走一个外部通道代码里只读不持有 Context。我这次就是把网络层的 Base URL 统一改到 TaoToken 的 API 通道。TaoToken 是一个大模型 API 的统一接入服务官网在 https://taotoken.net API 入口是 https://taotoken.net/api 。它的好处是 Key 和 Base URL 集中管理客户端只认一个地址不用在每个模块里散落配置也就减少了「配置对象持有 Context」的机会。先看改造前的写法问题就出在这里// 改造前单例持有 Activity Context配置变更时重建旧实例泄漏 public class ApiManager { private static ApiManager instance; private Context context; // 危险可能是 Activity private String baseUrl; private String apiKey; private ApiManager(Context context, String baseUrl, String apiKey) { this.context context; // 长生命周期对象持有短生命周期 Context this.baseUrl baseUrl; this.apiKey apiKey; } public static ApiManager getInstance(Context context, String baseUrl, String apiKey) { if (instance null) { instance new ApiManager(context, baseUrl, apiKey); } return instance; } }改造思路有三步第一单例不再持有任何 Context第二Base URL 和 Key 从统一的配置源读取不随实例走第三配置变更时只更新字段不重建实例。改完长这样// 改造后不持有 Context配置集中变更只更新字段 public class ApiManager { private static volatile ApiManager instance; private String baseUrl https://taotoken.net/api; private String apiKey; private String modelId; private ApiManager() { // 私有构造不接收 Context } public static ApiManager getInstance() { if (instance null) { synchronized (ApiManager.class) { if (instance null) { instance new ApiManager(); } } } return instance; } public void updateConfig(String apiKey, String modelId) { this.apiKey apiKey; this.modelId modelId; // 只更新字段不重建实例避免旧对象泄漏 } }如果你用的是 Gradle 项目配置可以放到local.properties或者构建配置里避免硬编码。下面是一个可复制的build.gradle片段把 Base URL 和 Model ID 作为 BuildConfig 字段注入// app/build.gradle android { defaultConfig { buildConfigField String, TAOTOKEN_BASE_URL, \https://taotoken.net/api\ buildConfigField String, TAOTOKEN_MODEL_ID, \your-model-id\ } }Key 这种敏感信息不要写进代码库建议放local.properties再读进来# local.properties不要提交到 git taotoken.api.keysk-xxxxxxxxxxxxxxxx然后在build.gradle里读取def localProps new Properties() def localFile rootProject.file(local.properties) if (localFile.exists()) { localProps.load(new FileInputStream(localFile)) } android { defaultConfig { buildConfigField String, TAOTOKEN_API_KEY, \${localProps[taotoken.api.key] ?: }\ } }这样网络层拿到的就是BuildConfig.TAOTOKEN_BASE_URL和BuildConfig.TAOTOKEN_API_KEY跟任何 Context 都没关系。配置变更时调用updateConfig即可实例始终是同一个不会产生「旧实例被静态引用」的泄漏。如果你用的是 Kotlin 和 Retrofit配置可以更干净// NetworkModule.kt object NetworkModule { private const val BASE_URL https://taotoken.net/api val apiService: ApiService by lazy { Retrofit.Builder() .baseUrl(BASE_URL) .client(okHttpClient()) .addConverterFactory(GsonConverterFactory.create()) .build() .create(ApiService::class.java) } private fun okHttpClient(): OkHttpClient { return OkHttpClient.Builder() .addInterceptor { chain - val request chain.request().newBuilder() .header(Authorization, Bearer ${BuildConfig.TAOTOKEN_API_KEY}) .header(Content-Type, application/json) .build() chain.proceed(request) } .build() } }注意这里object是 Kotlin 的单例by lazy保证只初始化一次且不持有任何 Activity。Base URL 写死成 TaoToken 的 API 地址Key 从 BuildConfig 读Model ID 在具体请求体里指定。这样网络层就跟 UI 层彻底解耦了。配置改完之后还要确认请求能正常发出去。你可以先用 curl 验证一下通道是否通curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: your-model-id, messages: [{role: user, content: ping}] }返回 200 且有正常 JSON 响应说明 Base URL 和 Key 都对。这一步很关键因为后面用 Profiler 抓堆的时候如果网络请求本身在疯狂重试、疯狂创建对象也会干扰内存分析。先把通道调通再排查泄漏链路才干净。4. 用 Profiler 和 LeakCanary 复现并定位泄漏点配置改完接下来就是复现和定位。工具用两个Android Studio Profiler 看整体内存趋势和堆快照LeakCanary 抓具体的泄漏引用链。两个配合用效率最高。先说 Profiler 的抓取步骤。打开 Android Studio连上真机或模拟器运行你的 App然后点底部或侧边的 Profiler 面板。选中你的进程进入 Memory 视图。这时候你会看到一条实时内存曲线蓝色是已分配灰色是空闲。复现步骤要刻意一点反复进出那个可疑页面比如从列表进详情、返回、再进、再返回来回二十次。同时观察内存曲线。如果每次进出后内存的「地板」都比上一次高一点而且手动触发 GC点 Profiler 里的垃圾桶图标之后也降不回原来的水平那基本可以确定有泄漏。确认有泄漏后点 Profiler 里的「Dump Java heap」抓堆快照。抓完会生成一个.hprof文件Android Studio 会自动打开分析界面。在左上角的类列表里按 Instance Count 排序找那些实例数量异常多的类。我这次就是看到MainActivity的实例数有二十多个正常应该只有一个。点进MainActivity看它的 References 面板会列出所有引用它的对象。顺着引用链往上找找到那个「不该持有它」的对象。我这次找到的是一个静态的ApiManager实例它的context字段指向了 Activity。引用链大概是这样的MainActivity (leaked) - context (field) - ApiManager instance (static) - ApiManager.instance (static field) - class ApiManager看到这条链问题就明确了静态单例持有 Activity Context。修复方式就是前面说的单例不持有 Context配置跟实例解耦。Profiler 能告诉你「谁泄漏了」但引用链有时候比较深看起来费劲。这时候 LeakCanary 就派上用场了。它会在 Activity 销毁后自动检测如果发现对象没被回收就 dump 堆并分析引用链最后给你一个通知点开就是完整的泄漏路径比手动翻 Profiler 快很多。接入 LeakCanary 很简单在app/build.gradle里加依赖dependencies { debugImplementation com.squareup.leakcanary:leakcanary-android:2.14 }注意是debugImplementation只在 debug 包生效不会影响 release。加完之后重新跑 AppLeakCanary 会自动初始化不需要你在 Application 里写任何代码2.x 版本自动安装。然后重复刚才的复现步骤进出页面二十次。如果 LeakCanary 检测到泄漏会在通知栏弹一个提示点开能看到类似这样的引用链MainActivity has leaked: * static ApiManager.instance * ↳ ApiManager.context * ↳ MainActivity这条链比 Profiler 里看的更直观直接告诉你「静态的 ApiManager 实例通过 context 字段持有了 MainActivity」。修复就是让 ApiManager 不再持有 context。修复后怎么验证重新跑一遍复现步骤再抓一次堆快照看MainActivity的实例数是不是回到 1。或者看 LeakCanary 是否还弹通知。如果实例数正常、通知不再出现说明泄漏修好了。这里有个细节要注意Profiler 抓堆前最好手动触发一次 GC否则有些「待回收但还没回收」的对象会干扰判断。LeakCanary 内部会自己触发 GC所以不用手动。另外抓堆快照本身会让 App 卡顿几秒这是正常的别以为是 ANR。还有一点如果你在排查过程中发现内存曲线一直涨但找不到明显的大对象可能是「内存抖动」而不是泄漏。抖动是短时间内大量创建和销毁对象导致 GC 频繁曲线呈锯齿状。这种情况要看分配情况而不是堆快照。Profiler 的 Memory 视图里可以看 Allocation能定位到具体哪行代码在疯狂分配。5. 排查路上常见的报错和坑这一节列几个我在排查过程中真实遇到的报错和坑你大概率也会碰上。第一个是401 Unauthorized。改完 Base URL 之后请求一直返回 401。原因通常是 Key 没带上或者带错了位置。TaoToken 的鉴权是Authorization: Bearer key注意 Bearer 后面有个空格。如果你用的是拦截器检查一下 header 有没有被覆盖。还有一种可能是 Key 从local.properties读的时候带了引号或者空格打印出来看看实际值。第二个是local proxy failed或者连接超时。这个多半是 Base URL 写错了比如漏了/api或者多了斜杠。正确的地址是https://taotoken.net/api请求路径拼成https://taotoken.net/api/v1/chat/completions。如果你在模拟器里跑确认模拟器网络正常真机的话确认没开什么奇怪的网络工具。注意这里不要用任何网络代理工具直接连就行。第三个是解析响应时报reading choices相关的错误比如Expected BEGIN_ARRAY but was BEGIN_OBJECT或者cannot read field choices。这通常是响应结构和你的数据类对不上。TaoToken 返回的是标准的 OpenAI 兼容格式choices是个数组每个元素里有message。检查你的 Gson 或 Moshi 数据类字段名是否匹配别把choices写成choice。第四个是 OAuth 相关的报错比如OAuth token expired或invalid_grant。如果你用的是需要 OAuth 的接入方式确认 token 没过期刷新逻辑正常。不过大部分场景用 API Key 就够了不需要走 OAuth。第五个坑是 LeakCanary 没反应。明明有泄漏但通知不弹。检查两点一是依赖是不是debugImplementationrelease 包不生效二是 App 是不是在 debug 模式下跑。另外有些系统会限制后台通知去设置里把 LeakCanary 的通知权限打开。第六个坑是 Profiler 抓不到堆。可能是设备 API 版本太低或者 App 开了android:debuggablefalse。Profiler 需要 debug 包才能抓堆确认你跑的是 debug 变体。第七个坑比较隐蔽修完泄漏后内存还是涨。这时候要区分是「泄漏」还是「缓存」。比如图片库的 LRU 缓存本来就会占内存只要不超过上限就是正常的。看 Profiler 里 GC 后能不能降下来能降就是缓存降不下来才是泄漏。还有一个跟配置相关的坑改了 Base URL 之后忘了同步改 Model ID。请求发出去了但返回model not found。Model ID 要跟你实际使用的模型对上别照抄别人的。这个错误不会导致内存问题但会让你误以为网络层没配好浪费排查时间。最后提醒一句排查内存泄漏时尽量在真机上做模拟器的内存行为和真机有差异。而且真机的内存上限更接近用户实际场景复现更准。6. 把配置和排查链路固化下来走到这里你应该已经能复现泄漏、定位引用链、修掉问题并且验证修复效果了。最后说几个把这条链路固化下来的实用技巧。第一把 Base URL 和 Key 的读取封装成一个独立的配置类不依赖任何 Context。这样网络层永远不会因为配置而持有 UI 对象。配置类可以长这样object ApiConfig { val baseUrl: String BuildConfig.TAOTOKEN_BASE_URL val apiKey: String BuildConfig.TAOTOKEN_API_KEY val modelId: String BuildConfig.TAOTOKEN_MODEL_ID }第二在 CI 或者提交前加一个简单的检查扫描代码里有没有「静态字段持有 Context」的写法。可以用 Lint 自定义规则也可以简单 grep 一下static.*Context。早发现早修比等到 OOM 再查省事得多。第三把 LeakCanary 常驻在 debug 包里每次开发新页面都顺手进出几次看有没有泄漏通知。养成习惯之后大部分泄漏在开发阶段就被拦住了不会流到线上。第四Profiler 的堆快照可以保存下来跟修复前的对比。修复前MainActivity实例数 20修复后应该是 1。这种对比数据在写复盘或者跟团队同步时很有说服力。如果你在接入 TaoToken 的过程中需要查具体的接口文档可以看接入文档想先试试模型对话效果可以直接在模型对话里发几条消息验证通道如果是长期做编码或者 Agent 类项目Coding Plan 会更合适。Key 的管理在 API Keys 页面控制台在 console。这些入口都在官网 https://taotoken.net 上能找到。排查内存泄漏这件事工具只是辅助核心还是理解「谁持有了谁」。把引用链理清楚问题就解决了一大半。剩下的就是把这些步骤变成肌肉记忆下次再遇到 OOM你能十分钟内定位到泄漏点。