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.key=sk-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。加完之后重新跑 App，LeakCanary 会自动初始化，不需要你在 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 没反应。明明有泄漏，但通知不弹。检查两点：一是依赖是不是debugImplementation，release 包不生效；二是 App 是不是在 debug 模式下跑。另外，有些系统会限制后台通知，去设置里把 LeakCanary 的通知权限打开。
第六个坑是 Profiler 抓不到堆。可能是设备 API 版本太低，或者 App 开了android:debuggable="false"。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，你能十分钟内定位到泄漏点。
 实战：用 .NET 与 Python 构建多智能体工作流)
