audio标签全平台兼容必须同时满足三件事:多格式source显式声明type、autoplay与muted共存、用户交互后JS调用play()并捕获错误;缺一即在iOS、微信WebView或旧Android静默失败。

audio 标签必须显式写 controls,且至少提供 MP3 + OGG + WAV 三格式 source,按此顺序静态声明——否则 iOS Safari、旧版 Firefox、部分企业内网环境大概率静音或完全不加载。
为什么只写一个 src 或只放 MP3 就播不了
浏览器不会“猜”你给的文件能不能解码,它只认 type 值匹配的 MIME 类型。漏掉 type,Safari(尤其 iOS)直接跳过该 source,canplay 不触发、duration 为 NaN,控制台还可能静默失败。
-
<source src="a.mp3"></source>→ iOS Safari 拒绝加载,无报错,也无控件响应 -
<source src="a.mp3" type="audio/mp3"></source>→ 无效 MIME,所有现代浏览器都跳过 - 正确写法只能是:
<source src="a.mp3" type="audio/mpeg"></source> - 服务器返回的
Content-Type响应头也必须匹配,比如 Nginx 要配audio/mpeg mp3;
source 的顺序和格式选择怎么定
浏览器从上到下尝试每个 source,遇到第一个 canPlayType() 返回非空字符串的就停。顺序 = 实际兼容优先级,不是“越多越好”。
- 第一位必须是
<source src="a.mp3" type="audio/mpeg"></source>:覆盖 Chrome、Safari、Edge;避开 VBR 编码(Firefox 可能卡住) - 第二位
<source src="a.ogg" type="audio/ogg"></source>:仅限纯 Vorbis 音频(用ffprobe a.ogg确认),Firefox/Chrome 稳定;别加codecs=vorbis,反而降兼容 - 第三位
<source src="a.wav" type="audio/wav"></source>:Safari(尤其 iOS)对 WAV 支持最稳,适合短提示音;但体积大、加载慢,仅作兜底 - OPUS 可选但非必需:
<source src="a.opus" type="audio/opus"></source>,Chrome/Firefox 支持好、体积小 30%~50%,但 Safari 仍不支持
常见坑点:本地开发、自动播放、JS 触发失败
双击 HTML 文件打开(file:// 协议)时,Chrome/Firefox 会拒绝加载 OGG/WAV,报 net::ERR_FAILED;autoplay 在现代浏览器中默认被拦截,即使写了也大概率静音或失败。
立即学习“前端免费学习笔记(深入)”;
- 本地开发务必起服务:
python3 -m http.server 8000或等效工具 -
autoplay必须搭配muted才可能生效;有声自动播放不可行,必须由用户手势触发(如按钮点击) - JS 调用
play()必须用.catch()捕获拒绝:audio.play().catch(e => console.warn(e.name)),常见错误包括NotAllowedError、NotSupportedError、AbortError -
controls="false"是典型陷阱——浏览器当真值处理,控件照常显示,且 JS 无法通过removeAttribute('controls')干净关闭
最容易被忽略的是服务器 MIME 配置和用户手势时机:没配对的 Content-Type 响应头,再规范的 HTML 也白搭;而 JS 中在 DOMContentLoaded 里直接调 play() 几乎必败,必须绑定一次真实用户交互事件。



















