第4章 Retrofit 接口实例泄漏：动态代理对象被静态持有、匿名内部类隐式引用

4.2 数据采集：heap dump 快照分析

// 典型 MAT 引用链输出（简化）
class com.example.app.MainActivity
  \- static field com.example.app.SingleHolder.retrofitService
    \- java.lang.reflect.Proxy (Retrofit 动态代理接口)
      \- okhttp3.RealCall
        \- retrofit2.OkHttpCall$1 (匿名内部类)
          \- com.example.app.MainActivity (this$0)

4.3 原因定位：两类常见泄漏模式

4.4 修复动作

针对模式A：动态代理静态持有

• 将 Retrofit 接口实例改为局部变量，按需创建或通过 Application Scope 单例注入（但避免放在静态长生命周期集合中）。
• 若必须缓存接口实例，使用 WeakHashMap 或 Lifecycle 感知容器。

// ❌ 错误：静态持有
public class GlobalApiHolder {
    private static MyApi api = RetrofitClient.create(MyApi.class);
}

// ✅ 修复：改为 WeakReference 或 Per-Activity 实例
public class ApiProvider {
    private static WeakHashMap<Activity, MyApi> cache = new WeakHashMap<>();
    
    public static MyApi get(Activity activity) {
        MyApi api = cache.get(activity);
        if (api == null) {
            api = RetrofitClient.create(MyApi.class);
            cache.put(activity, api);
        }
        return api;
    }
}

针对模式B：匿名内部类隐式引用

• 将匿名 Callback 改为 静态内部类 + 弱引用外部对象，或直接取消引用。
• 在 Activity.onDestroy() 中 取消所有进行中的 Call（call.cancel()）。
• 使用 Lifecycle-Aware 组件（如 LiveData / Coroutine 配合 lifecycleScope）自动清理。

// ❌ 错误：匿名 Callback 持有 Activity
api.getData().enqueue(new Callback<Data>() {
    @Override
    public void onResponse(Call<Data> call, Response<Data> response) {
        // 隐式持有 Activity.this
        textView.setText(...);
    }
});

// ✅ 修复：使用静态内部类 + WeakReference
private static class MyCallback implements Callback<Data> {
    private WeakReference<Activity> activityRef;
    
    MyCallback(Activity activity) {
        activityRef = new WeakReference<>(activity);
    }
    
    @Override
    public void onResponse(Call<Data> call, Response<Data> response) {
        Activity act = activityRef.get();
        if (act != null) {
            act.runOnUiThread(() -> ((MainActivity)act).textView.setText(...));
        }
    }
}
// 使用：api.getData().enqueue(new MyCallback(this));

4.5 复测：验证泄漏根除

1. 运行应用，反复进入/退出目标页面（至少 5 次）。
2. 在 退出 Activity 后执行 GC（Memory Profiler 中点击 Garbage Collect）。
3. 再次 Dump Java Heap，搜索 Activity 实例数。
4. 检查引用链：Proxy 和 Callback 是否仍指向已销毁的 Activity。

// 复测通过判断：Activity 实例数 ≤ 1（当前可见的），且 GC Roots 无指向 it 的强引用。

4.6 预防：工程化手段