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

先抛结论：在iOS/macOS系统里，只要设备处于静音模式，Web Audio API就是不出声的。这不是代码的问题，是底层音频路由直接把它给拦截了。所以，解决问题的路径只有三条：要么先把静音关掉，要么确保AudioContext是在用户手势之后创建的，要么干脆换方案，用HTML5的audio标签。

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

问题出在系统层面。当iPhone或iPad处于系统级静音模式时——不管是拨动物理开关到静音侧，还是在控制中心开启了“静音模式”——Web Audio API创建的AudioContext就会默认被强制静音。这时候，哪怕你JavaScript里正确调用了audioContext.resume()，用户也完成了一次点击，音频缓冲也加载完了，它就是不出声。注意，这不是权限问题，而是iOS/macOS的底层音频路由策略直接把Web Audio的输出通道给掐断了。

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

怎么判断？在iPhone或iPad上，从右上角向下滑动打开控制中心，看看顶部状态栏右侧有没有一个月牙形的【静音模式图标】。如果有，说明硬件级静音已经开启，Web Audio API必然不工作，这就是个硬门槛，绕不过去。

要是你的设备有响铃/静音物理开关，请确认这个开关是朝前拨的（不露出橙色）。否则，不管代码怎么优化，它都保持静默。

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

还有一种情况：设备没静音，但还是没声音。那就要看AudioContext是什么时候创建的。Web Audio API要求，AudioContext必须由明确的用户手势触发才能正常运行。简单说，你得在用户点击按钮的那一刹那去创建它。如果代码放在DOMContentLoaded或load事件里，那上下文就会处于“挂起”状态，resume()也会静默失败。

方法一：用一次点击解封上下文。在按钮的点击事件里执行：const audioContext = new (window.AudioContext || window.webkitAudioContext)(); audioContext.resume();。注意，必须放在这个回调里，其他地方无效。

方法二：监听首次交互后自动恢复。给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，重新上传再测试一次。