Android Java从SD卡播放WAV音频文件报错求助

你遇到的Error (-38,0)和stop called in state 1错误，大多和MediaPlayer的状态管理不当或者文件访问权限/格式问题有关，下面一步步帮你排查解决：

1. 先搞懂错误背后的原因 #

• stop called in state 1：MediaPlayer的状态码1对应MEDIA_PLAYER_INITIALIZED（已完成初始化但还没准备好播放），这时候调用stop()就会触发这个错误——说明你的代码里可能在MediaPlayer还没准备完成时就调用了stop，或者之前的MediaPlayer实例状态没清理干净。
• Error (-38,0)：这个错误通常表示MediaPlayer处于不允许当前操作的状态，比如在未准备好时强行播放，或者重复使用未释放的实例导致状态混乱。

2. 常见问题的具体解决方案 #

（1）先确认SD卡访问权限 #

从Android 6.0（API 23）开始，访问外部存储需要动态申请权限，哪怕你已经在Manifest里加了权限声明，也要在运行时主动申请：

// 先检查权限是否已获取
if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE)
        != PackageManager.PERMISSION_GRANTED) {
    // 申请存储权限
    ActivityCompat.requestPermissions(this,
            new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},
            1001);
} else {
    // 权限已拿到，执行播放逻辑
    playWavFile(fileNamePath);
}

// 处理权限申请的结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == 1001) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            playWavFile(fileNamePath);
        } else {
            Toast.makeText(this, "需要存储权限才能播放音频文件", Toast.LENGTH_SHORT).show();
        }
    }
}

（2）改用异步prepare，严格管理MediaPlayer状态 #

你原来用的同步mp.prepare()如果遇到大文件或者读取慢的情况，容易阻塞线程，还容易出现状态问题。建议换成异步准备，通过监听器确保准备完成后再播放：

private MediaPlayer mp;

private void playWavFile(String filePath) {
    // 先释放之前的实例，避免状态混乱
    if (mp != null) {
        mp.stop();
        mp.release();
        mp = null;
    }

    mp = new MediaPlayer();
    try {
        mp.setDataSource(filePath);
        // 准备完成后再触发播放
        mp.setOnPreparedListener(mediaPlayer -> mediaPlayer.start());
        // 出错时及时释放资源
        mp.setOnErrorListener((mediaPlayer, what, extra) -> {
            Log.e("MediaPlayerError", "错误码: " + what + ", 额外信息: " + extra);
            mediaPlayer.release();
            mp = null;
            return true;
        });
        mp.prepareAsync(); // 异步准备，不会阻塞主线程
    } catch (IOException e) {
        e.printStackTrace();
        // 异常时也要清理资源
        if (mp != null) {
            mp.release();
            mp = null;
        }
    }
}

（3）检查WAV文件格式是否兼容 #

MediaPlayer只支持PCM编码的WAV文件（不支持压缩编码的WAV），通常还要求：

• 采样率：44.1kHz或48kHz
• 位深：16位
• 声道：单声道或立体声

你可以用Audacity这类音频工具检查并转换文件格式，确保符合要求。

（4）避免重复操作未释放的MediaPlayer实例 #

每次播放前一定要释放之前的MediaPlayer，不要重复使用同一个实例却不清理，否则很容易出现状态冲突，触发stop called in state 1这类错误。

最后验证步骤 #

1. 先确认存储权限已正确获取；
2. 替换为兼容格式的WAV文件测试；
3. 使用上面的异步prepare代码，严格管理MediaPlayer的生命周期。

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