真正能落地的兼容方案必须同时处理格式、MIME、触发时机三件事:type须为audio/mpeg而非audio/mp3;本地需HTTP服务而非file://;play()必须由用户手势同步触发并捕获Promise错误。

只写一个 <source src="a.mp3"></source> 就想播通所有浏览器?基本没戏。真正能落地的兼容方案,必须同时处理格式、MIME、触发时机三件事。
audio/mpeg 还是 audio/mp3?type 值写错直接被 Safari 忽略
浏览器靠 type 属性决定是否尝试加载该 <source></source>,不是靠文件后缀猜。Safari(尤其 iOS)对 type 错误零容忍——type="audio/mp3" 是无效值,它会跳过整条 <source></source>,导致 canplay 不触发、duration 为 NaN,且控制台静默失败。
-
type="audio/mpeg"是 MP3 的正确 MIME 类型(RFC 4853),Chrome、Safari、Edge 都认 -
type="audio/ogg"对应 Vorbis 编码的 OGG(用ffprobe a.ogg确认 Stream 是Audio: vorbis) - 别写
type="audio/wav"后又塞 IEEE Float 编码 WAV——Chrome 直接拒解码 - Ogg 和 MP3 顺序建议:MP3 放第一(兼容最广),OGG 放第二(Firefox/Chrome 备选)
本地双击 HTML 测试?Chrome 会直接封禁音频加载
用 file:// 协议打开 HTML,Chrome/Firefox 会因安全策略阻止音频资源加载,连请求都不发,Network 面板里根本看不到音频项。这不是代码问题,是协议限制。
- 本地开发必须起 HTTP 服务:
python3 -m http.server 8000或 VS Code Live Server 插件 - 验证是否生效:打开 Network 面板,点播放,看音频请求是否返回
200,且 Response Headers 里Content-Type精确匹配(如audio/mpeg) - 服务器没配 MIME?Apache 加
AddType audio/mpeg .mp3;Nginx 在types块补audio/mpeg mp3;
点了按钮还是没声音?不是 JS 写错了,是 play() 被浏览器拦截了
audio.play() 返回 Promise,现代浏览器(Chrome ≥70、Safari ≥12.1、Firefox ≥66)强制要求:有声播放必须由用户手势(click/touchstart/keydown)同步触发。在 load、canplay 回调里调用,Promise 必 reject,控制台报 "The play() request was interrupted"。
立即学习“前端免费学习笔记(深入)”;
- 可靠写法:绑定一次用户交互,例如
document.body.addEventListener('click', () => audio.play().catch(e => {}), { once: true }) - 微信 iOS 更严格:需等
WeixinJSBridgeReady事件后再调play() - autoplay + muted 可静音自动播,但前提是
preload="metadata"(iOS Safari 无视preload="auto") - 务必
.catch()捕获失败,否则无声时控制台可能不报错
CORS 报错但音频路径明明是对的?跨域音频要 server + HTML 双配合
音频跨域比图片严格得多。即使服务端返回了 Access-Control-Allow-Origin: *,若 HTML 中 <audio></audio> 标签没加 crossorigin 属性,浏览器仍当普通资源处理,拒绝解码。
- HTML 侧必须写:
<audio crossorigin="anonymous"><source src="https://cdn.example.com/a.mp3" type="audio/mpeg"></source></audio> - 服务端除了
Access-Control-Allow-Origin,还必须允许Range请求头(流式加载依赖它) - 移动端调试时注意:iOS Safari 对跨域音频更敏感,常静默失败,优先本地同源测试
最容易被忽略的是:你以为“格式写了、type 对了、路径通了”就万事大吉,其实服务器 MIME 配错、file:// 协议下测试、或 play() 调用时机脱离用户手势——这三个点任何一个出问题,都会导致完全无声且无明确报错。



















