Android 10 MediaPlayer prepareAsync抛出IllegalStateException异常
根因定位
- 异常的直接触发原因是MediaPlayer状态机校验失败:
prepareAsync()方法要求调用时MediaPlayer必须处于Initialized状态(即setDataSource()已成功完成、拿到有效文件数据源)。从异常栈来看,此时MediaPlayer还停留在Idle状态,说明之前的setDataSource()操作实际没有成功初始化数据源,但未被Java层的异常捕获逻辑感知。 - 深层原因是Android 10分区存储(Scoped Storage)规则的限制:
- 低于Android10的版本上,应用拿到
MediaStore.Audio.Media.DATA列返回的外部存储物理路径后,可以直接通过文件路径访问MP3文件,setDataSource(File)能正常打开文件、切换到合法的初始化状态。 - Android10开始默认开启分区存储,应用不再具备直接通过物理文件路径访问外部共享目录文件的权限,即使从MediaStore查询到的路径存在,直接通过File对象打开也会被系统拒绝。这种场景下
setDataSource()不会抛出可被捕获的Java层IO异常,仅在Native层标记数据源无效,最终导致状态机不满足prepareAsync()的调用前置条件,抛出IllegalStateException。
- 低于Android10的版本上,应用拿到
适配方案
- 替换物理文件路径的数据源获取逻辑,不再依赖
MediaStore.Audio.Media.DATA列:- MediaStore查询时新增读取
MediaStore.Audio.Media._ID列,通过ContentUris.withAppendedId(MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, id)拼接生成对应的内容URI,将该URI作为音频文件的唯一标识保存,不再存储物理路径字符串。
- MediaStore查询时新增读取
- 修改MediaPlayer的数据源设置方式:
- 弃用传入File对象的
setDataSource()方法,改用支持Content URI的重载方法setDataSource(context, audioUri),由系统通过ContentResolver为应用授权打开目标文件,绕过分区存储对直接路径访问的限制。
- 弃用传入File对象的
- 修正错误流程的中断逻辑:
- 在
setDataSource()的异常捕获块中,明确中断后续执行流程,避免在数据源初始化失败的情况下继续调用prepareAsync(),从代码层面规避状态机异常。
- 在
- 兼容低版本的临时适配(非长期方案):
- 如果需要短期兼容Android10设备且不想立刻迁移URI访问逻辑,可在
AndroidManifest.xml的application节点下声明android:requestLegacyExternalStorage="true",临时关闭Android10的分区存储限制。注意该配置在Android11及以上系统会失效,仅作为过渡方案使用。
- 如果需要短期兼容Android10设备且不想立刻迁移URI访问逻辑,可在
内容的提问来源于stack exchange,提问作者Alex
相关产品推荐
相关产品推荐

