常见的直播网页场景是:页面放在一个域名下,播放地址则通过另一个域名分发。例如,页面来自 www.example.com,视频资源来自直播加速域名。浏览器会比较两者的协议、域名和端口;其中一项不同,就可能构成跨域。若资源响应中没有符合要求的 CORS 响应头,播放器可能报跨域错误,或者无法读取媒体资源。
这类问题不能只靠在网页里加代码解决。是否允许网页读取资源,由浏览器根据服务器返回的响应头判断。通常需要检查实际提供资源的服务端或 CDN 配置。排查时也别只盯着播放器提示:403、404、鉴权失败或格式不兼容,都可能让播放中断,但处理方法与 CORS 不同。
先确认跨域影响的是哪类请求
浏览器的同源策略会检查页面和资源的协议、域名、端口。网页请求阿里云直播域名上的播放清单、分片或其他媒体资源时,浏览器会查看响应中的 Access-Control-Allow-Origin 等 CORS 响应头。即使资源地址能直接打开,网页脚本仍可能没有权限读取它。
跨域不等于直播流本身不可用。如果同一播放地址在某些客户端或命令行工具中能访问,但网页播放器失败,浏览器拦截响应是一个排查方向。若请求本身返回 403、404,或资源格式不兼容,则应结合状态码和响应内容继续判断,不能仅凭播放器报错认定为跨域。
播放协议不同,请求链路也会有差异。HLS 通常先请求 m3u8 清单,再请求 ts 或 fMP4 分片;HTTP-FLV 会持续请求媒体数据;WebRTC 还涉及信令和媒体连接,排查方式与普通 HTTP 资源不完全相同。先在浏览器开发者工具的 Network 面板中确认播放器实际请求了哪些 URL,再逐项检查响应,比只看播放器的一条提示更可靠。
配置跨域时要核对哪些响应头
- Access-Control-Allow-Origin:指定允许访问资源的页面来源。正式环境可填写实际来源,例如 https://www.example.com。注意来源包含协议,不能只写域名。
- Access-Control-Allow-Methods:根据请求情况允许 GET、HEAD 等方法。如果浏览器发出 OPTIONS 预检请求,还要确认这类请求能得到正确响应。
- Access-Control-Allow-Headers:请求带有 Range、Authorization 或自定义请求头时,检查所需请求头是否在允许范围内。
- Access-Control-Expose-Headers:只有播放器需要读取某些响应头时,才需要配置暴露对应字段。浏览器不会默认向脚本开放所有响应头。
- Access-Control-Allow-Credentials:确实使用 Cookie 或凭据模式时再配置。此时 Allow-Origin 不能设为 *,需要返回具体来源。
在阿里云环境中,应按域名的接入方式检查对应的 CDN 或直播域名配置。如果资源经过 CDN 加速,浏览器最终看到的是边缘节点返回的响应;即使源站已经加了跨域头,CDN 配置、缓存或代理处理仍可能影响结果。若跨域头由源站设置,也要确认 CDN 没有覆盖响应头,或继续返回旧缓存。
控制台的菜单和可配置项可能随产品及版本调整,具体以当前控制台说明为准。检查时可以先明确资源由哪一层返回,再沿着源站、CDN、反向代理或网关逐层核对,避免在错误的位置修改配置。
电脑能打开播放地址,网页却报跨域
例如,活动页面部署在 https://event.example.com,播放地址使用阿里云直播加速域名。运营人员打开页面后,播放器提示无法加载 m3u8;将播放地址复制到新标签页,却能看到文件内容。开发者工具显示清单请求返回 200,但响应中没有 Access-Control-Allow-Origin。
这时,问题不一定出在推流环节。浏览器收到了清单,却没有获得读取跨域响应的许可。排查人员需要先确认页面的实际 Origin 和播放请求地址,再检查资源对应的加速链路是否允许该来源。若浏览器发出了 OPTIONS 请求,也要确认 CDN、网关或源站没有拒绝它。
配置调整后,还要留意缓存。若响应头仍是旧值,可以检查相关缓存是否需要刷新或等待更新,再重新请求清单和分片。只看到 m3u8 能加载还不够:清单中的分片可能使用另一个域名,也可能经过不同的加速配置。最好把清单、分片以及播放器实际请求的其他资源都检查一遍。
阿里云直播跨域排查步骤
- 记录完整请求链路。在开发者工具中查看页面来源、播放域名、清单和分片 URL,并记录各请求的状态码、请求头和响应头。不要只复制播放器提示文字。
- 按状态码区分问题。请求返回 200 但浏览器提示 CORS 时,检查跨域响应头;403 可进一步检查鉴权、Referer 防盗链或签名;404 要核对路径和资源是否存在;超时则继续排查网络、域名解析和回源。
- 检查 OPTIONS 预检。请求带有自定义头、特定方法等情况时,浏览器可能先发送 OPTIONS。若这一步被 CDN、网关或源站拒绝,后续的 GET 请求即使单独可访问,网页播放仍可能失败。
- 沿最终响应位置排查。有 CDN、反向代理或网关时,浏览器读取的是最外层返回结果。检查跨域头是否被覆盖、重复添加,或因为缓存没有更新而仍返回旧值。
- 用实际页面来源复测。确认 Allow-Origin 与带协议的页面来源一致。直接打开文件地址或使用本地工具测试,不能代替浏览器在真实页面中的 CORS 检查。
配置中容易忽略的边界
CORS 不负责授予播放权限。允许某个来源读取资源,不代表它自动通过了鉴权。若启用了 URL 鉴权、时间戳签名或访问控制,签名失效仍可能返回拒绝响应。排查时要分别核对 CORS 响应头和鉴权结果,也不要把密钥放进前端代码。
不要无条件开放所有来源。通配来源有时适用于公开且不使用凭据的资源,但是否合适要看业务安全要求。涉及 Cookie 或凭据时,必须指定具体来源,并按要求返回凭据相关响应头。上线前可以先用实际页面验证,再把允许范围收窄到业务所需域名。
清单和分片要分别验证。HLS 清单中的分片地址可能指向其他域名,播放器也可能继续请求密钥或字幕。只给主播放域名配置跨域,不一定覆盖整条媒体链路。修改后若浏览器仍报错,先检查失败的具体请求,再确认对应域名的配置和缓存状态。
排查阿里云直播跨域时,先定位浏览器实际请求的资源,再看状态码、响应头和请求链路。这样更容易把 CORS 与鉴权、缓存、格式或网络故障分开处理。发布前用真实页面测试清单、分片和预检请求,也能避免只修好首个请求、播放仍在后续环节中断。