MediaSessionCompat仅在Android 8设备触发NullPointerException问题求助

嘿，这个坑我太熟了！Android 8.0/8.1版本对MediaSessionCompat的兼容性问题确实挺闹心，你遇到的这个空指针崩溃，大概率和MediaSession的生命周期管理、引用回收或者版本兼容性有关。我来给你拆解几个常见原因和对应的解决办法：

1. 务必绑定MediaSession到组件生命周期，及时释放资源 #

Android 8.x的系统对后台组件的回收机制更激进，如果你的MediaSession在全局上下文（比如Application）里初始化，或者没在组件销毁时及时释放，很容易导致它的内部引用被系统回收，触发空指针。

正确做法：把MediaSessionCompat和Activity/Fragment的生命周期绑定，在onCreate里初始化，onDestroy里主动释放：

private MediaSessionCompat mMediaSession;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 初始化时传入当前组件的Context，不要用Application Context
    mMediaSession = new MediaSessionCompat(this, "YourMediaSessionTag");
    mMediaSession.setActive(true);
}

@Override
protected void onDestroy() {
    super.onDestroy();
    // 先设为非活跃状态，再释放资源
    if (mMediaSession != null) {
        mMediaSession.setActive(false);
        mMediaSession.release();
        mMediaSession = null;
    }
}

2. 避免Callback被提前回收 #

很多人会把MediaSession的Callback写成局部变量，或者用匿名内部类但没有强引用持有，在Android 8.x的GC机制下，这个Callback的弱引用很容易被回收，导致MediaSession调用回调时触发空指针。

解决办法：把Callback声明为类的成员变量，确保它的生命周期和MediaSession一致：

// 成员变量持有Callback，避免被GC回收
private MediaSessionCompat.Callback mMediaCallback = new MediaSessionCompat.Callback() {
    @Override
    public void onPlay() {
        // 你的播放逻辑
    }

    @Override
    public void onPause() {
        // 你的暂停逻辑
    }
};

// 在初始化MediaSession时设置Callback
mMediaSession.setCallback(mMediaCallback);

3. 升级到最新的AndroidX Media库 #

旧版本的support库或者早期的AndroidX Media库在Android 8.x上存在已知的兼容性bug，导致内部Reference处理异常。建议你把依赖升级到最新的androidx.media版本：

在build.gradle（Module级别）里更新依赖：

dependencies {
    // 替换成最新版本，比如1.6.0或更高
    implementation "androidx.media:media:1.6.0"
}

注意：如果之前用的是support库的MediaSessionCompat，要完全替换成androidx的androidx.media.session.MediaSessionCompat，避免混合依赖导致冲突。

4. 后台播放场景必须绑定前台服务 #

如果你的应用需要在后台播放媒体，Android 8.x要求必须使用前台服务，否则系统会限制后台组件的运行，导致MediaSession的资源被回收。

做法：创建一个前台服务，在服务内部初始化MediaSession，并调用startForeground()方法：

public class MediaPlaybackService extends Service {
    private MediaSessionCompat mMediaSession;

    @Override
    public void onCreate() {
        super.onCreate();
        mMediaSession = new MediaSessionCompat(this, "ServiceMediaSessionTag");
        mMediaSession.setActive(true);

        // 创建通知，启动前台服务
        Notification notification = createMediaNotification();
        startForeground(1, notification);
    }

    // 实现创建媒体通知的方法
    private Notification createMediaNotification() {
        // 这里写你的媒体通知逻辑
        return new NotificationCompat.Builder(this, "media_channel")
                .setContentTitle("正在播放")
                .setSmallIcon(R.drawable.ic_play)
                .build();
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        if (mMediaSession != null) {
            mMediaSession.setActive(false);
            mMediaSession.release();
        }
        stopForeground(true);
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}

额外调试建议 #

• 用LeakCanary检测内存泄漏，看看是否有MediaSession相关的对象被意外持有或者释放不及时；
• 在崩溃发生的代码附近添加日志，追踪MediaSession和Callback的引用状态，确认是哪个环节出现了空引用。

内容的提问来源于stack exchange，提问作者Олег Місько