Android MediaRecorder录音报外部存储访问错误,已声明权限仍异常
MediaRecorder 外部存储访问报错根因排查
高频触发原因
- 仅配置Manifest静态存储权限,未适配权限申请机制与分区存储规则
Android 6.0(API23)之后READ_EXTERNAL_STORAGE、WRITE_EXTERNAL_STORAGE属于危险权限,仅在Manifest声明不会自动生效,必须在运行时动态申请授权后才能获得对应目录的写入能力。
更核心的常见漏配点是Android 10(API29)引入的分区存储机制:就算完成了旧版存储权限的动态申请,targetSdk版本>=30的应用默认也无法直接访问传统外部存储的公共自定义路径,此时如果给MediaRecorder设置的输出路径是硬编码的/sdcard下的自定义文件夹,就会在调用start()启动录音的节点直接抛出external storage access error。
对应修复方案:
- 如果录制的音频仅为应用内部复用,优先使用应用专属外部存储路径
context.getExternalFilesDir(null).absolutePath,该路径不需要任何存储权限即可读写,无权限适配成本。 - 如果需要将音频存入公共录音目录供其他应用读取,需要通过MediaStore API完成文件写入,不要直接拼接传统sdcard路径。
- 针对targetSdk=29的临时适配:可在Manifest的application节点添加
android:requestLegacyExternalStorage="true"临时关闭分区存储,但该配置在Android 11及以上版本会失效。
- 输出路径配置错误
参考早期教程硬编码文件路径、未提前创建输出文件的父目录、路径权限校验遗漏,都会触发同类存储访问报错。这类问题可以在设置MediaRecorder输出路径前,提前判断父目录存在性、文件可写状态快速定位。 - 核心权限漏配
部分定制系统在RECORD_AUDIO权限未声明、未动态授权的场景下,会模糊抛出存储类的错误日志,而非直接提示录音权限缺失,需要同时检查Manifest中是否声明录音权限、是否在运行时获得对应授权。
可直接复用的无权限录制代码片段
// 应用专属外部存储路径,无需申请存储权限 File outputDir = getExternalFilesDir(Environment.DIRECTORY_MUSIC); if (!outputDir.exists()) { outputDir.mkdirs(); } File audioFile = new File(outputDir, "recording_" + System.currentTimeMillis() + ".m4a"); MediaRecorder mediaRecorder = new MediaRecorder(); mediaRecorder.setAudioSource(MediaRecorder.AudioSource.MIC); mediaRecorder.setOutputFormat(MediaRecorder.OutputFormat.MPEG_4); mediaRecorder.setAudioEncoder(MediaRecorder.AudioEncoder.AAC); mediaRecorder.setOutputFile(audioFile.getAbsolutePath()); mediaRecorder.prepare(); mediaRecorder.start();
内容的提问来源于stack exchange,提问作者Aziz
相关产品推荐
相关产品推荐

