HTML5音频跨域需显式设置crossorigin属性并配全服务端CORS响应头，否则将出现静默失败；公开资源用crossorigin="anonymous"，受保护资源用crossorigin="use-credentials"，且服务端必须返回Access-Control-Allow-Origin、Access-Control-Allow-Headers: Range等必要头。
HTML5 中 audio 音频的“媒体污染”并不是标准术语，实际指的是因跨域加载引发的安全限制导致的播放失败、元数据不可读、拖拽异常或解码报错等问题。本质是浏览器对跨域媒体资源的严格策略——它不阻止资源下载，但会阻断 JS 对媒体信息的访问和部分播放行为，从而让音频看似“加载了却不能用”。解决关键在于前后端协同配置，而非单靠前端加个属性。
必须明确：crossorigin 属性不是可选项，而是触发机制
仅在 audio 标签上写 <audio src="https://cdn.example.com/song.mp3"></audio>，即使服务端返回了 Access-Control-Allow-Origin: *，浏览器仍按普通非 CORS 请求处理，JS 无法读取 duration、buffered，loadedmetadata 事件可能不触发，拖拽（seek）也会失败。
正确写法需显式声明 crossorigin 值：
-
公开资源（如 CDN 上的 MP3）：用
crossorigin="anonymous"，且必须带引号，不能写成crossorigin或crossorigin="" -
需登录态的音频（如后端 API 返回的受保护流）：用
crossorigin="use-credentials"，此时服务端Access-Control-Allow-Origin必须指定具体域名，不能为* -
属性顺序很重要：crossorigin 必须在设置
src之前就存在；动态赋值（先 new Audio() 再设 crossOrigin 再设 src）无效
服务端响应头缺一不可
前端加了 crossorigin，只是告诉浏览器“这次走 CORS 流程”，真正决定能否通过的是服务端返回的响应头。音频比图片、脚本更敏感，必须同时满足：
立即学习“前端免费学习笔记（深入）”；
-
Access-Control-Allow-Origin：匹配当前页面 Origin，或为*（但后者不兼容use-credentials） -
Access-Control-Allow-Headers: Range：必需！没有它，浏览器无法发起分片请求，拖拽、缓冲、Safari/Chrome 流式加载全部失效 -
Access-Control-Expose-Headers: Content-Range：推荐添加，否则 JS 无法读取分块响应中的Content-Range字段 - 若用
use-credentials，还必须返回：Access-Control-Allow-Credentials: true
Nginx 示例配置（针对 .mp3 文件）：
location ~ \.mp3$ {add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Headers' 'Range';
add_header 'Access-Control-Expose-Headers' 'Content-Range';
add_header 'Access-Control-Max-Age' '2592000';
}
警惕这些“静默失败”陷阱
很多问题不会直接报错，而是表现为音频卡住、时长显示 NaN、拖动无反应、play() 被拒绝等。常见诱因：
- 重定向丢失 CORS 头：CDN 返回 302 到另一个域名，而最终目标服务器没配 CORS → 浏览器只看最后一跳，头缺失即失败
- 本地 file:// 协议打开 HTML：所有 crossorigin 请求被禁用（Origin 为 null），控制台提示 “CORS request not http” 类错误
-
MIME 类型错误：服务器返回
text/plain或空类型，而非audio/mpeg，浏览器拒绝解码 -
服务端返回了 CORS 头，但拼写错误或大小写不一致：比如
access-control-allow-origin（小写）在某些环境下不被识别
什么时候可以不加 crossorigin？
如果只是单纯用 <audio controls></audio> 播放，不调用 JS 读取元数据、不拖拽、不解码、不传给 WebRTC 或 Canvas，那不加 crossorigin 也能播——但这属于“能响不能用”的状态，一旦后续需要扩展功能（比如显示进度条、分析音频波形），就会突然崩掉。所以建议：只要跨域，一律加，统一规范，避免后期踩坑。
