Hey Carlos，我帮你梳理几个最可能导致音频文件创建失败的常见问题，你可以逐一排查：

首先要确保权限配置和动态申请都到位，安卓对录音、存储这类敏感操作管控很严：

• Manifest声明权限：在AndroidManifest.xml里添加必要权限，注意区分安卓版本：

  <!-- 录音权限 -->
  <uses-permission android:name="android.permission.RECORD_AUDIO" />
  <!-- Android 10 以下的外部存储权限 -->
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />
  <!-- Android 13+ 针对媒体文件的权限（如果存到公共目录） -->
  <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
  

• 动态权限申请：安卓6.0+（API 23）及以上，危险权限必须在运行时申请，录音和存储都属于危险权限。你需要在代码里检查权限是否已授予，未授予的话主动请求：

  String[] permissions = {Manifest.permission.RECORD_AUDIO, Manifest.permission.WRITE_EXTERNAL_STORAGE};
  if (ContextCompat.checkSelfPermission(this, Manifest.permission.RECORD_AUDIO) != PackageManager.PERMISSION_GRANTED
          || ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
      ActivityCompat.requestPermissions(this, permissions, 1001);
  }
  

  还要记得处理权限申请的回调，确保用户授予后再启动录制。

存储路径错误是文件创建失败的高频原因，尤其是安卓10+引入的Scoped Storage机制：

• 内部存储（APP私有）：用ContextWrapper的getFilesDir()获取路径，这里是APP私有目录，不需要存储权限，确保路径正确：

  ContextWrapper cw = new ContextWrapper(getApplicationContext());
  File audioDir = cw.getFilesDir();
  File audioFile = new File(audioDir, "my_recording.mp3");
  

• 外部存储：
  • 如果是APP私有外部存储（卸载APP会删除），用getExternalFilesDir()，同样不需要存储权限，但要先确保目录存在：

    File externalDir = getExternalFilesDir(Environment.DIRECTORY_MUSIC);
    if (!externalDir.exists()) {
        externalDir.mkdirs(); // 先创建目录，否则文件无法写入
    }
    File audioFile = new File(externalDir, "my_recording.mp3");
    

  • 如果是公共目录（比如系统Music文件夹），安卓10+不能直接用File类创建，必须用MediaStore API写入，否则会报错。
• 另外要检查文件名是否合法，避免使用冒号、斜杠、问号这类系统禁止的特殊字符。

MediaRecorder的配置顺序非常严格，错一步都会导致文件创建失败：
正确的配置顺序应该是：

MediaRecorder mediaRecorder = new MediaRecorder();
// 1. 设置音频源
mediaRecorder.setAudioSource(MediaRecorder.AudioSource.MIC);
// 2. 设置输出格式
mediaRecorder.setOutputFormat(MediaRecorder.OutputFormat.MPEG_4);
// 3. 设置音频编码器（要和输出格式匹配）
mediaRecorder.setAudioEncoder(MediaRecorder.AudioEncoder.AAC);
// 4. 设置输出文件路径
mediaRecorder.setOutputFile(audioFile.getAbsolutePath());
// 5. 准备录制
try {
    mediaRecorder.prepare();
} catch (IOException e) {
    e.printStackTrace();
    // 这里打印异常，能快速定位配置问题
}
// 6. 开始录制
mediaRecorder.start();

录制结束后，必须正确释放资源，否则文件可能损坏或不完整：

mediaRecorder.stop();
mediaRecorder.release();
mediaRecorder = null;

如果以上排查都没问题，建议加日志定位问题：

• 打印文件路径，确认路径是否正确：

  Log.d("AudioDebug", "Audio file path: " + audioFile.getAbsolutePath());
  Log.d("AudioDebug", "File exists after recording? " + audioFile.exists());
  Log.d("AudioDebug", "File size: " + audioFile.length() + " bytes");
  

• 捕获MediaRecorder的异常，比如prepare()时的IOException，异常信息会告诉你具体哪里出错。
• 用Android Studio的Device File Explorer直接查看对应目录，确认文件是否真的没生成，还是只是系统媒体库没刷新（如果是公共目录，可能需要扫描媒体库才能显示）。

如果这些步骤都排查完还是解决不了问题，你可以把完整的主活动代码和AndroidManifest.xml贴出来，我帮你更精准地定位问题~

内容的提问来源于stack exchange，提问作者Carlos Borrás