本地 audio 播放失败主因是 file:// 协议被浏览器安全策略拦截,须改用 HTTP 服务(如 Live Server 或 python3 -m http.server);同时确保 MIME 类型正确(audio/mpeg/audio/ogg/audio/wav)、canPlayType() 检测通过、音频文件为真实对应编码格式。

本地开发时 audio 播不了,先确认是不是 file:// 协议问题
浏览器在 file:// 协议下会直接拦截音频加载,Chrome、Firefox、Edge 全部静默失败——Network 面板里可能根本看不到请求,控制台也不报错。这不是代码问题,是安全策略硬限制。
必须启用本地 HTTP 服务再测:
- VS Code 用户:装
Live Server插件,右键 HTML 文件选 “Open with Live Server” - 命令行用户:进项目根目录,运行
python3 -m http.server 8000,然后访问http://localhost:8000 - 路径必须用相对 URL,比如
src="audio/intro.mp3",不能写src="./audio/intro.mp3"或绝对file://路径
检查 audio/mpeg 等 MIME 类型是否真被服务器返回
即使 Network 面板显示 200,音频仍可能不响。关键看响应头里的 Content-Type —— 浏览器只认 audio/mpeg、audio/ogg、audio/wav 这三类,其他如 text/plain 或空值,都会被当文本丢弃。
验证步骤:
立即学习“前端免费学习笔记(深入)”;
- 打开 DevTools → Network 标签页
- 刷新页面,点击音频请求(状态码为 200 的那个)
- 切换到 Headers → Response Headers,找
Content-Type字段 - 若不是
audio/mpeg(MP3)、audio/ogg(Vorbis 编码 OGG)或audio/wav,就得配服务器
本地 Python 服务默认不设 MIME,需手动补;Apache 加 AddType audio/mpeg .mp3 到 .htaccess;Nginx 在 types 块加 audio/mpeg mp3;。
用 canPlayType() 实时判断浏览器是否真支持该格式
canPlayType() 是唯一可靠的运行时检测方式,它不看文件后缀,只查当前浏览器解码器是否认这个 MIME + 编码组合。
实操建议:
- 在控制台执行:
const a = document.createElement('audio'); a.canPlayType('audio/mpeg') - 返回
"probably"表示高置信度可用;"maybe"表示容器匹配但编码不确定;空字符串""就是不支持 - 别只传
audio/mp4—— Safari 必须写audio/mp4; codecs="aac"才可能返回非空 - 测试务必用真机或真机调试模式,Chrome DevTools 的 Device Mode 对编解码器判断常失真
验证音频文件本身是否“真 MP3”而不是套壳假货
改后缀不等于改格式。很多 .mp3 文件实际是 AAC 编码或 MP3float,浏览器无法解码。
用 ffprobe 查真实编码:
-
ffprobe intro.mp3应输出Audio: mp3, 44100 Hz, stereo, fltp, 128 kb/s(注意是mp3,不是mp3float或aac) -
ffprobe sound.ogg必须含Audio: vorbis;若显示opus,Safari 旧版本大概率跳过 -
.wav要避开 IEEE Float 编码,Chrome 会拒播;推荐用ffmpeg -i input.wav -c:a pcm_s16le output.wav转成标准 PCM
最常被忽略的一点:你以为的“转换”,其实是重命名。真转换得用 ffmpeg -i input.wav -c:a libmp3lame output.mp3,否则浏览器加载失败后静默跳过下一个 <source></source>。



















