Qt5.15调用QAudioDecoder.start()触发ResourceError错误如何解决

• 编解码器依赖缺失：Qt 5.15的QAudioDecoder本身不内置MP3解码支持，完全依赖系统底层多媒体框架的解码组件，Linux环境下默认未安装GStreamer对应的MP3解码插件时，无法识别MP3资源就会触发ResourceError。
• 调用顺序错误：你当前代码先调用setAudioFormat设置输出格式，再设置源文件，QAudioDecoder的输出格式配置需要在识别源文件编码参数后才能生效，提前强制设置自定义格式会导致解码器无法匹配输入的MP3编码规则，启动失败。
• 文件访问异常：目标MP3路径/home/root/test.mp3属于root用户目录，若当前运行程序的用户没有读取权限、文件不存在或文件本身损坏，也会触发资源类错误。

1. 安装底层解码依赖 #

Linux桌面环境直接执行如下命令安装所需插件：

apt install gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-libav qtmultimedia5-dev

如果是嵌入式Linux环境，需要在根文件系统编译阶段将上述GStreamer插件集成到镜像中

2. 修正代码调用顺序 #

移除提前设置输出格式的逻辑，等解码器读取源文件参数完成后再配置输出规则，修正后代码参考：

m_decoder =  new QAudioDecoder();
// 先设置源文件让解码器识别编码参数
m_decoder->setSourceFilename("/home/root/test.mp3");

// 解码器完成格式识别后触发该信号，可在这里匹配QAudioOutput参数
connect(m_decoder, &QAudioDecoder::formatChanged, this, [=](const QAudioFormat &format){
    qDebug() << "解码器输出格式：" << format;
    // 若格式不符合预期可在这里添加转码逻辑
});
// 新增错误捕获方便定位具体问题
connect(m_decoder, &QAudioDecoder::errorOccurred, this, [=](QAudioDecoder::Error error){
    qDebug() << "解码错误详情：" << error << m_decoder->errorString();
});

connect(m_decoder, &QAudioDecoder::bufferReady, this, &Audio::bufferReady);
m_decoder->start();

3. 校验文件访问权限 #

手动执行命令确认文件存在且可读：

ls -l /home/root/test.mp3

若权限不足，可将文件移动到当前程序用户可访问的目录，或通过chmod命令调整文件读取权限。

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