为什么Safari浏览器的Web Audio API在设备静音模式下会完全无声

Web Audio API在iOS/macOS系统静音模式下必然无声，因底层音频路由直接拦截输出；需先解除硬件静音，再确保AudioContext由用户手势触发初始化，或改用HTML5 audio标签绕过限制。

Web Audio API在设备静音模式下无声的根本原因

当iPhone或iPad处于系统级静音模式（响铃/静音开关拨至静音侧，或控制中心中“静音模式”开启）时，Web Audio API创建的AudioContext默认被系统强制静音，即使JavaScript已成功调用audioContext.resume()、页面有用户手势触发、音频缓冲加载完成，也完全不会输出任何声音——这不是权限未获取，而是iOS/macOS底层音频路由策略直接拦截了所有Web Audio输出通道。

验证当前是否处于系统静音模式

在iPhone或iPad上，从右上角向下滑动打开控制中心，查看顶部状态栏右侧是否有月牙形【静音模式图标】亮起；若存在，说明系统已启用硬件级静音，Web Audio API必然无输出，此为不可绕过前提条件。

有响铃/静音物理开关的设备，请确认该开关朝前拨动（不露出橙色），否则Web Audio无论代码如何优化都保持静默。

解除静音后仍无声？检查AudioContext初始化时机

Web Audio API要求AudioContext必须由明确的用户手势（如点击、触摸、键盘按键）触发初始化，否则即使设备未静音，上下文也处于“挂起”状态，resume()会静默失败。

方法一：用一次点击解封上下文
在按钮点击事件中执行：const audioContext = new (window.AudioContext || window.webkitAudioContext)(); audioContext.resume();。这一步不能放在DOMContentLoaded或load事件里，否则无效。

方法二：监听首次交互后自动恢复
给document绑定一次click或touchstart事件，在回调中创建并resume()上下文，之后移除监听器。避免重复调用resume()报错。

绕过静音限制的替代方案：改用HTML5

HTML5

将原Web Audio流程替换为：，然后在用户点击后调用document.getElementById('player').play()。

注意：此方案放弃Web Audio的低延迟、混音、滤波等高级能力，仅适用于基础提示音、背景音乐等简单场景。

终极排查：确认音频文件本身可播放

第一步：在Safari中直接访问音频文件URL（如https://example.com/alert.mp3），看能否正常播放并出声。
第二步：若直接访问也无声，说明文件损坏、格式不被iOS支持（如WAV未压缩、FLAC）、或服务器未正确返回Content-Type: audio/mpeg响应头。
第三步：换用MP3格式，采样率设为44100 Hz，比特率≥128 kbps，重新上传测试。