audio标签不播放需先检查src路径和MIME类型;确认请求返回200且Content-Type为audio/mpeg、audio/ogg或audio/wav;避免file://协议、相对路径404、后端未配置MIME、iOS无用户手势触发等问题。

audio 标签不播放,先查 src 路径和 MIME 类型
浏览器静默拒绝音频加载时,控制台往往不报错,但 Network 面板会暴露真相。必须确认两点:src 请求返回 200,且响应头 Content-Type 是 audio/mpeg(MP3)、audio/ogg(OGG)或 audio/wav(WAV)之一。
常见踩坑点:
- 本地用
file://协议打开 HTML —— Chrome 直接禁用加载,play()会抛DOMException: play() failed because the user didn't interact with the document first -
src写相对路径(如./sound.mp3),在 Vue Router history 模式或子路由下容易 404 - 后端没配对 MIME 类型(比如 Nginx 缺少
types { audio/mpeg mp3; }),Safari 和 Firefox 就当普通文件下载
iOS Safari 播放失败,重点看 preload 和用户手势
iOS Safari 对音频控制最严:没有真实触摸/点击触发,play() 必然失败,连 autoplay + muted 都可能被无视。
实操建议:
立即学习“前端免费学习笔记(深入)”;
- 所有
play()调用必须包裹在click或touchstart回调里,别放在mounted、load或canplay事件中 -
preload="auto"在 iOS 上无效甚至引发卡顿,改用preload="metadata",只拉取时长和元信息 - 微信 iOS WebView 更狠:即使
muted,首次播放仍需用户至少一次触摸页面任意位置,之后才能自动续播
多格式 fallback 要按浏览器支持顺序静态写死
别指望 JS 动态判断再插入 source —— canPlayType() 返回 "probably" 不等于“一定能播”,尤其在 Safari 对 VBR 编码 MP3 的兼容性差时更不可靠。
正确写法是静态声明,按兼容性从高到低排列:
<audio controls> <source src="sound.mp3" type="audio/mpeg"> <source src="sound.ogg" type="audio/ogg"> <source src="sound.wav" type="audio/wav"> 您的浏览器不支持 audio 标签。 </audio>
理由:
- MP3 兼容最广,但 Firefox/Safari 对某些 VBR 编码有解码问题
- OGG(Vorbis)在 Chrome/Firefox 表现稳定,Safari 完全不支持
- WAV 无压缩、体积大,只适合短提示音(如“叮”一声),避免拖慢首屏
静音自动播放不是万能解,muted 属性必须显式存在且 volume 未被覆盖
Chrome 84+ 允许静音自动播放,但条件苛刻:
-
muted必须作为布尔属性写在标签里(<audio muted></audio>),写成muted="true"或muted="false"都无效 -
volume初始值必须为0;如果后续 JS 执行了audio.volume = 0.5,哪怕再设回0,也大概率触发策略重检并拦截 - 移动端(尤其 iOS)仍可能要求首次交互,不能完全依赖该机制
真正跨平台稳住音频链路,核心不是堆属性,而是把播放动作锚定在用户可感知的交互节点上——这点比任何 fallback 或 polyfill 都关键。



















