ios和微信h5音频自动播放失效是因audiocontext需用户手势触发才能resume，且微信仅认click事件；safari还受系统静音开关、标签页静音及自动播放策略三重限制，必须用muted+autoplay启动后由点击解禁。
音频在不同浏览器和设备上“不响”，90% 不是代码写错了，而是没按平台规则触发播放、没覆盖格式、或根本没走对测试路径。直接开 Chrome DevTools 看控制台报错，解决不了 iOS Safari 静音失败、Android WebView 解码崩溃、Safari 无痕模式 localStorage 抛错这类问题。
怎么确认 audio 标签被浏览器真正识别
很多“没声音”其实是标签压根没被解析成 HTMLAudioElement，尤其在 IE10 或旧版 Android WebView 中。
- 打开 DevTools → Elements 面板，手动展开 DOM，确认
<audio></audio>节点存在且未被自动包裹进<div> 或折叠为空节点 <li>在 Console 执行 <code>document.querySelector('audio')，返回null就说明 HTML 结构或 DOCTYPE 有问题 - 检查
是否独占第一行——前面有空格、BOM 或注释，IE 和部分 WebView 会退到 Quirks 模式，<code>audio变成未知 inline 元素 - 若用 Modernizr，查
Modernizr.audio返回值；但注意：它只表示元素构造函数存在，不等于能播任何格式 - 所有
play()必须包在用户事件回调里：button.addEventListener('click', () => audio.play())，不能提前绑定或异步调用 -
preload="metadata"是 iOS 必选项；preload="auto"会被忽略，还可能卡住首帧 - 本地开发用
file://协议时，Chrome/iOS Safari 均禁用play()，必须起本地服务器（如python3 -m http.server 8000） - 即使加了
muted，也要确保 JS 没后续改写audio.muted = false或audio.volume = 1，否则静音自动播放立即失效 -
<source></source>必须按兼容性从高到低排列：mp3→ogg→wav（WAV 仅作兜底，体积大、解码慢） - 打开 Network 面板，看哪个
source发起了请求且返回 200；如果全 404，说明路径或 MIME 类型错误（如服务器没配audio/mpeg） - 在 Safari 中右键音频控件 → “检查元素”，看
<audio></audio>的src属性是否已自动指向第一个成功加载的source - 用
audio.addEventListener('error', e => console.log('failed:', audio.error?.code))捕获错误；code === 4表示所有source均不可用 - iOS 远程调试要三开关全开：iPhone 设置 → Safari → 高级 → Web Inspector；macOS Safari 偏好设置 → 高级 → Show Develop menu；首次 USB 连接点“信任此电脑”
- Android WebView 调试连不上？先确认
WebView.setWebContentsDebuggingEnabled(true)写在Application.onCreate()里，且只对android:debuggable="true"的 debug 包生效 - 局域网访问本地服务，手机不能输
localhost；启动服务时绑定0.0.0.0:3000，手机浏览器访问http://192.168.x.x:3000；嫌配 IP 麻烦，直接用npx serve（默认监听所有接口）
为什么 audio.play() 在 iOS Safari 里总失败
iOS Safari 对音频播放的限制不是“能不能”，而是“谁触发的”。它不认 load、canplay、甚至 setTimeout 里的 play()，只认用户手势（click/touchend）同步上下文。
如何验证多格式 fallback 是否真生效
别信 canPlayType() 返回 "probably"——Firefox 对 MP3 的判断常为 ""，Safari 对 OGG 返回 "maybe" 却实际跳过。真实兼容性得靠 DOM 顺序 + 网络加载结果反推。
真机测试时最容易漏掉的三个细节
模拟器能骗过样式和基础 API，但播不出声、触控延迟、网络降级这些，必须真机连 Wi-Fi 测。
音频兼容不是“一次测完就稳了”。Safari 16.4 修复了 dialog.showModal() 的 close 事件，但引入了 inert 在某些场景下不响应的问题；OPUS 格式在 Chrome 125+ 支持更好，可替代部分 WAV 场景——关键逻辑永远要运行时验证，而不是依赖静态检测或文档承诺。
