真正能响的音频方案必须组合多格式+正确type声明+服务端mime配置+用户手势触发;mp3放首位,opus次之,wav垫底;type必须为audio/mpeg等标准值;服务端content-type须匹配;play()须绑定click等真实用户事件。

直接说结论:只写一个 <audio src="x.mp3"></audio>,90% 的浏览器会静默失败;真正能响的方案必须组合 <source></source> 多格式 + 正确 type 声明 + 服务端 MIME 配置 + 用户手势触发逻辑。
<source></source> 必须写全,且顺序不能错
浏览器按 DOM 顺序逐个尝试 <source></source>,遇到第一个 canPlayType() 返回 "probably" 或 "maybe" 的就加载它。顺序错了,兼容性就崩了:
-
<source src="a.mp3" type="audio/mpeg"></source>—— MP3 兼容最广,放第一位 -
<source src="a.ogg" type="audio/ogg"></source>—— Firefox/Chrome 支持好,Safari 完全不认 -
<source src="a.opus" type="audio/opus"></source>—— Chrome/Firefox 支持,体积比 MP3 小 30%~50%,可作第二兜底(别放最后) -
<source src="a.wav" type="audio/wav"></source>—— Safari 对某些 OGG 不稳定时反而更可靠,但仅适合 ≤2 秒提示音,放最后
常见错误:
- 写成
type="audio/mp3"(错),必须是audio/mpeg - Ogg 文件实际是 Opus 编码却声明
type="audio/ogg",浏览器跳过 - 用
ffprobe a.ogg确认输出含Audio: vorbis才算真 Ogg/Vorbis
服务端 Content-Type 必须配对,否则 <source></source> 形同虚设
即使 <source></source> 写得再规范,如果服务器返回的响应头里 Content-Type 是 text/plain 或空着,浏览器根本不会把它当音频处理——连解码器都不调。
检查方式:打开 DevTools → Network → 点开音频请求 → 查看 Response Headers 中的 Content-Type。
配置建议:
- Apache:在
.htaccess加AddType audio/mpeg .mp3AddType audio/ogg .oggAddType audio/opus .opus - Nginx:在
types { }块里加audio/mpeg mp3;audio/ogg ogg;audio/opus opus; - 本地开发:别双击 HTML,用
python3 -m http.server 8000起服务
play() 调用必须由用户手势触发,且不能依赖 canplay 事件
iOS Safari 和 Chrome 84+ 都强制要求:首次 play() 必须发生在 click、touchstart、keydown 等真实用户事件回调中。在 DOMContentLoaded、load、甚至 canplay 里调,100% 报 NotAllowedError: play() failed because the user didn't interact with the document first。
正确写法示例:
<button id="playBtn">播放</button> <audio id="myAudio"><source src="sound.mp3" type="audio/mpeg"><source src="sound.opus" type="audio/opus"></source></source></audio>
const audio = document.getElementById('myAudio');
document.getElementById('playBtn').addEventListener('click', () => {
audio.play().catch(e => {
console.warn('播放被拒:', e.name); // 可能是 NotAllowedError / NotSupportedError / AbortError
});
});
注意:
- iOS 要求按钮在视口内、未被
display: none或opacity: 0遮挡,否则即使点过也静音 - 不要等
canplay再play(),iOS 不认这种“伪手动”上下文 -
preload="metadata"比auto更稳妥,避免移动端预加载阻塞
关键点其实就三个:格式兜底写对、服务端 MIME 对上、播放动作绑在真实点击里。最容易被忽略的是服务端配置——很多团队查了一整天 JS 逻辑,最后发现是 Nginx 没配 audio/ogg 类型,<source></source> 白写了。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











