WebVTT字幕跨域加载需同时满足:服务端返回Access-Control-Allow-Origin响应头,且video标签设置crossorigin属性;track标签无crossorigin属性,自动继承媒体元素CORS设置。

HTML5 中用 标签加载外部 WebVTT 字幕文件时,若字幕托管在跨域服务器上(比如 CDN 或第三方服务),必须满足 CORS(跨源资源共享)要求,否则浏览器会因安全策略拒绝加载字幕。
确保 WebVTT 文件支持 CORS
这是最关键的一步。字幕文件所在的服务器必须在响应头中明确允许当前页面域名访问:
- 响应头需包含
Access-Control-Allow-Origin: https://your-site.com(或*,但不推荐用于带凭据的请求) - 如果字幕请求需要携带 cookie 或认证信息(如
crossorigin="use-credentials"),则不能设为*,且需额外返回Access-Control-Allow-Credentials: true - 可通过浏览器开发者工具的 Network 面板检查字幕请求的响应头是否合规
正确设置
本身不发起跨域请求,但其父 或 元素的 crossorigin 属性会影响字幕加载行为:
- 若字幕地址跨域,必须给媒体元素(
)设置crossorigin属性,例如:<video controls crossorigin="anonymous"><br> <source src="https://example.com/video.mp4"><br> <track kind="subtitles" label="English" srclang="en" src="https://cdn.example.com/subs.en.vtt"><br></track></source></video>
-
crossorigin="anonymous"表示不发送凭据(推荐默认使用);crossorigin="use-credentials"仅在需鉴权时使用,且要求服务端响应头严格匹配 -
标签本身无需加crossorigin属性 —— 它没有该属性,浏览器会自动继承媒体元素的 CORS 设置
验证 WebVTT 文件格式与编码
即使 CORS 正确,字幕仍可能不显示,常见原因包括:
- 文件内容不是合法 WebVTT:首行必须是
WEBVTT(可后跟空格或换行),且无 BOM 头;建议用 UTF-8 无 BOM 编码保存 - 时间戳格式错误,如
00:00:01.234 --> 00:00:03.456中缺少空格、用错箭头(应为-->)或毫秒位数不对 - 服务器返回了非
text/vtt的 MIME 类型(如text/plain)。虽非强制,但建议服务端配置正确类型以避免潜在兼容性问题
调试技巧
当字幕不出现时,优先排查以下几点:
- 打开浏览器控制台,查看是否有 “
Failed to load resource: net::ERR_FAILED” 或 “Blocked by CORS policy” 报错 - 在 Network 面板中找到 .vtt 请求,确认状态码是 200,且响应头含正确的
Access-Control-Allow-Origin - 右键点击字幕轨道(播放器右下角“字幕”菜单),确认该 track 已被识别并启用(未灰显)
- 临时把 .vtt 文件放在同域下测试,排除格式或路径问题
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











