将ExoPlayer封装为独立类时出现Activity上下文泄漏问题求助

首先，ExoPlayer属于重量级组件，封装时如果没处理好生命周期绑定和引用持有关系，很容易让Activity被意外持有、无法被GC回收，最终引发泄漏甚至崩溃。结合你的场景，我整理了几个最可能的问题点：

1. 封装类持有Activity/View的强引用未释放 #

如果你的独立封装类直接持有Activity实例或它的View（比如播放用的SurfaceView）的强引用，却没在合适时机清空，哪怕Activity处于后台，ExoPlayer的工作线程（加载、播放线程）依然会攥着这个引用，导致Activity无法被回收。

修复方案：

• 改用WeakReference持有Activity/View，避免强引用绑定：

  class MyExoPlayerWrapper {
      private var activityRef: WeakReference<Activity>? = null
      private var surfaceViewRef: WeakReference<SurfaceView>? = null
  
      fun init(activity: Activity, surfaceView: SurfaceView) {
          activityRef = WeakReference(activity)
          surfaceViewRef = WeakReference(surfaceView)
          // 初始化ExoPlayer逻辑...
      }
  }
  

• 在Activity的onDestroy（或onStop，根据你的播放场景）中主动调用封装类的销毁方法，清空引用并释放ExoPlayer：

  // 封装类中添加销毁方法
  fun release() {
      exoPlayer?.release()
      exoPlayer = null
      activityRef?.clear()
      surfaceViewRef?.clear()
  }
  
  // Activity中同步生命周期
  override fun onDestroy() {
      super.onDestroy()
      myExoPlayerWrapper.release()
  }
  

2. 未同步ExoPlayer与Activity的生命周期 #

ExoPlayer有自己的状态逻辑（比如setPlayWhenReady、pause、release），如果封装类没和Activity的生命周期联动，比如Activity进入后台（onStop）时没暂停/释放ExoPlayer，它会一直持有相关资源和Activity引用。

修复方案：

• 在Activity的关键生命周期方法中调用封装类对应方法，同步状态：

  // Activity中
  override fun onStart() {
      super.onStart()
      myExoPlayerWrapper.resumePlayback() // 恢复播放
  }
  
  override fun onStop() {
      super.onStop()
      myExoPlayerWrapper.pausePlayback() // 暂停播放
      // 若后台不需要保持播放，可直接调用release释放资源
  }
  

• 针对API版本做适配：API 24+推荐在onStart初始化ExoPlayer、onStop释放；低于24则在onResume初始化、onPause释放，避免后台时无效持有资源。

3. 封装类使用静态实例导致永久引用 #

如果你的ExoPlayer封装类是单例模式，或者用静态变量持有Activity/View引用，这个引用会一直存留在内存中，哪怕Activity销毁也无法被回收，直接造成内存泄漏。

修复方案：

• 尽量避免用单例封装ExoPlayer，除非你能确保单例不会持有Activity强引用，且所有使用场景都能正确解除关联。
• 若必须用单例，务必用弱引用持有Activity，并且在Activity销毁时主动清空关联。

4. 未清理ExoPlayer的监听回调 #

如果给ExoPlayer设置了Player.Listener这类回调，而回调是由Activity或其内部类实现的，封装类没在合适时机移除这些监听，ExoPlayer会持有回调引用，进而间接持有Activity。

修复方案：

• 在封装类的release方法中，移除所有绑定给ExoPlayer的监听：

  fun release() {
      exoPlayer?.removeListener(playerListener)
      exoPlayer?.release()
      exoPlayer = null
  }
  

排查小技巧 #

你可以用Android Studio的Profiler或者LeakCanary工具定位具体的泄漏引用链，能精准找到封装类中哪部分持有了Activity的引用没释放——比如LeakCanary会直接告诉你是ExoPlayer的哪个线程或对象攥着Activity实例。

内容的提问来源于stack exchange，提问作者Nicholas Muir