SoundTouchJS与Web Audio API故障排查：音频无法播放、音调无偏移

我正在基于SoundTouchJS的共振峰修正工作单元开发纯前端Demo，参考了官方formant-correction-worklet包的实现，也编写了最小可复现示例（MRE）。预期点击开始按钮后播放上传的音频，同时将音调提高7个半音，但实际音频完全无法播放。

注：文件处理时长依大小而定，完成后开始按钮会启用，请求排查问题。

1. 检查Worklet加载与注册状态 #

• 确认AudioWorklet是否成功注册，控制台是否有加载失败报错（如跨域、文件路径错误），可添加错误捕获代码：

try {
  await audioContext.audioWorklet.addModule('formant-correction-worklet.js');
} catch (err) {
  console.error('Worklet加载失败:', err);
}

• 在线环境（如CodePen）中需确保Worklet文件的引入路径/CDN地址有效，避免404或跨域问题。

2. 验证音频解码与缓冲区处理 #

• 检查音频文件是否成功解码为AudioBuffer，可在解码后打印关键信息：

audioContext.decodeAudioData(arrayBuffer).then(buffer => {
  console.log('音频缓冲区信息:', buffer.duration, buffer.numberOfChannels);
  // 后续处理逻辑
});

• 若解码失败，优先排查上传文件格式（推荐使用MP3、WAV等标准格式），是否存在损坏情况。

3. 核对共振峰修正参数配置 #

• 确认音调偏移参数是否正确设置为7，检查Worklet节点的参数传递逻辑：

const formantNode = new AudioWorkletNode(audioContext, 'formant-correction-worklet');
formantNode.parameters.get('pitchSemitones').value = 7; // 确保赋值正确

• 查看Worklet内部process方法，验证参数是否被正确读取并应用到音频处理流程中。

4. 检查音频链路完整性 #

• 确保AudioBufferSourceNode、Worklet节点、AudioDestinationNode的连接链路无断裂：

sourceNode.connect(formantNode);
formantNode.connect(audioContext.destination);

• 确认sourceNode.start()在链路连接后被正确调用，未被异步逻辑阻塞。

5. 校验AudioContext状态与用户交互触发 #

• 浏览器要求音频上下文必须通过用户交互（如点击）激活，确认按钮点击事件中包含上下文恢复逻辑：

startButton.addEventListener('click', async () => {
  await audioContext.resume();
  // 播放音频逻辑
});

• 若AudioContext处于suspended状态，音频无法播放，需确保用户交互成功触发上下文恢复。

内容的提问来源于stack exchange，提问作者Michael Johnson Jr