导读:约 12 分钟读完;需要你部署过静态站点、会在命令行跑
curl;没配过 CDN 也能跟,第 4 节会把用到的两个云服务先讲清。
这篇写给「页面已经上线、但浏览器里有一类功能静默失效」的人。最典型的症状是:网页能打开、图片能显示,但依赖多线程的功能全部失效——比如游戏里的计算模块一个都没起来,控制台里只有一行 SecurityError: Failed to construct 'Worker'。读完你能带走四条配置规则、一张「什么组合会失败」的对照表,和三条能直接跑的验证命令。
| 读者 | 带走什么 | 拿它做什么 | 从哪节开始读 |
|---|---|---|---|
| 刚把站点绑到自有域名的人 | 四条入口与路径规则 | 按顺序检查自己的域名、协议、Worker 路径三处配置 | 5 |
| 用 CDN + 对象存储/静态托管部署的人 | 「回源重写」这套零代码方案 | 不用写跳转页,也不用云函数,就把地址栏固定成自有域名 | 5 |
| 遇到 Worker/SharedWorker 起不来的人 | 三条硬限制 + 验证命令 | 用 curl -I 和浏览器控制台两条线确认是不是跨域 |
6、8 |
不适合谁:只想搞懂 CDN 原理、不打算动手改配置的读者。
一句话:把站点搬到自有域名,本质上是在挪「源」(origin),而 Worker 对「源」的要求比普通请求严格得多。普通资源跨域,加个跨域响应头就能用;Worker 不行,它必须在创建那一刻就与页面同源。
下面这张表是全文导航,每行说清这一节解决什么问题:
| 小节 | 讲什么 | 解决什么问题 |
|---|---|---|
| 3 | 现象:页面正常、Worker 起不来 | 先确认你遇到的是不是同一类 |
| 4 | 环境准备 + 三个概念 | 装好验证工具,建立「源」的概念 |
| 5 | 为什么要自有域名 + 完整配置顺序 | 知道每一步为什么存在、好处是什么 |
| 6 | 四个坑,逐个拆 | 每个坑的现象、成因、修法 |
| 7 | 五种配置组合对照表 | 对照自己的配置会落在哪一格 |
| 8 | 判据:三条命令 | 改完怎么确认真的好了 |
| 9 | 性能上的取舍 | 同源不等于最快,资源该走哪条路 |
先说现场。站点已经绑好自有域名,浏览器打开一切正常:HTML、CSS、图片、首屏资源都出来了。但依赖多线程的计算模块一个都没起来——原本交给 Worker 干的活全部停摆。打开控制台,只有一行:
Uncaught DOMException: Failed to construct 'Worker':
Script at 'https://example-cdn.com/assets/worker.js'
cannot be accessed from origin 'https://www.example.com'.
这行报错已经把答案写出来了:创建 Worker 的脚本地址,和页面的源不是同一个。难的是找出「为什么它们不是同一个」——因为配置里明明写着同一个域名。
配之前先备好三样:域名解析控制台、CDN 控制台、一个能跑 curl 的终端。下面这条命令用来确认后两样是否就绪——它会打印版本号和一次域名解析结果:
curl --version | head -n 1
nslookup example.com
# 两条都有输出:一条看 curl 可用,一条看解析是否生效
源(origin):浏览器用来判断「是不是自己人」的三元组——协议 + 域名 + 端口,三者全同才算同源。http://a.com 和 https://a.com 是两个源;https://a.com 和 https://www.a.com 也是两个源。这条规则是后面所有坑的根。
CloudBase:腾讯云的无服务器云服务,其中的静态托管可以理解成「把构建产物按文件上传,平台负责对外提供访问」。它省掉了自己买服务器、配 Nginx 这些事,代价是平台会给你一个默认域名 xxx.tcloudbaseapp.com——这个默认域名就是「源站」,真正存文件的地方。
EdgeOne:腾讯云的 CDN(内容分发网络),把文件缓存到各地的边缘节点,访客就近取。它还有一层「边缘规则」,能在请求到达源站之前做改写、跳转、加响应头。我用它是因为它能在**加速区域选「全球(不含中国大陆)」**的模式下工作——这个模式不需要 ICP 备案,正好适合没有备案的个人域名。
把三者连起来:访客访问 https://www.example.com → 解析到 EdgeOne → EdgeOne 去源站(CloudBase 的默认域名)取文件 → 返回给访客。访客眼里的源是自有域名,而文件实际住在 CloudBase。
分三段说清,因为这三件事经常被混成一句「配个域名就行」。
为什么要做:不绑域名,站点只能通过平台默认域名访问,有三个具体麻烦。分享出去的链接是一串随机字符;搜索引擎会把默认域名和以后的自有域名当成两个地址;哪天换托管平台,所有链接全断。
怎么做:按顺序四步。
^/(.*)$ → /gts_play_pro/dist/$1。意思是访客请求 https://www.example.com/blog/x/,EdgeOne 到源站取的是 /gts_play_pro/dist/blog/x/。这样既保持了地址栏不变,又不用改构建产物的任何一行路径。有什么好处:地址栏从头到尾是自有域名,分享链接稳定、搜索引擎只记一个地址;换托管平台时只改源站,对外链接不用动;全程零代码,没有跳转页、也没有云函数。
这里有个容易走偏的替代方案:不用回源重写,改成「让平台在访问时 302 到默认域名」。它也能打开页面,但地址栏会跳成 xxx.tcloudbaseapp.com,前面说的三个好处全没了。回源重写之所以是首选,是因为它在服务端完成改写,访客永远看不到第二个域名。换别家 CDN 也成立——关键不是哪家厂商,而是入口层必须同时支持「改写回源路径」和「强制 HTTPS」这两件事。
场景:域名刚解析好,你用 http:// 打开过一次,一切正常;第二天用 https:// 打开,Worker 起不来了。
为什么是坑:页面是 https、Worker 脚本地址是 http(或者反过来)时,协议不同就是不同源。更隐蔽的是「协议相对地址」——写成 //www.example.com/x.js 时,浏览器会继承当前页面的协议,页面还是 http 时它还是 http,看起来什么都没错。
怎么解决:在入口层强制 HTTPS,用 301 把 http 请求永久转到 https,而不是在页面里写跳转脚本。页面层跳转只能救「已经加载了页面」的情况,救不了 Worker 构造那一刻。
为什么能解决:所有入口最后都只剩一个协议,源的三要素里协议这一项固定了。实测中,玩家在 Vivo 手机、Chromium 146 上就是被这一条卡住,控制台报 SecurityError。
场景:你确认页面和 Worker 脚本都在同一个域名下,还是起不来。
为什么是坑:Worker 的约束比普通资源多。下面这张表列出三条最容易互相混淆的限制,以及每条最典型的误判:
| 限制 | 具体是什么 | 常见误解 |
|---|---|---|
| 创建必须同源 | new Worker(url) 的 url 必须与页面同源,跨域直接抛错 |
以为加了跨域响应头就行 |
| 302 不免责 | 同源地址被 302 到跨域地址,浏览器仍按跨域拒绝 | 以为「最终拿到的内容同源」就行 |
| 路径解析会跟 base 走 | 页面里若有 base 标签,/worker.js 这类相对路径会按 base 的源解析 |
以为 / 开头就是当前域名 |
怎么解决:给 Worker 脚本写同源绝对地址(https://www.example.com/assets/worker.js,结尾带斜杠表示目录),不要依赖相对路径和 base。
为什么能解决:地址里把协议、域名、端口都写死了,浏览器解析时不需要再做任何继承,302 也不会介入。
顺带说清一个常见混淆:importScripts() 是可以跨域的,但那只适用于「Worker 已经建好之后,在里面再加载脚本」。创建 Worker 这一步不能跨域,两件事不能互相替代。这一点决定了后面的架构取舍。
场景:为了让静态资源走更快的 CDN,你给页面加了 base 指向 CDN 域名,同时把资源基址写成 CDN 的绝对地址。资源确实快了,Worker 却全灭。
为什么是坑:base 改变的是页面内相对路径的解析基准。Worker 路径写成 /assets/worker.js 时,浏览器按 base 的源展开,真实地址变成了 CDN 域名——于是「页面在自有域名、Worker 在 CDN 域名」,又跨域了。
怎么解决:把 Worker 路径从 base 的管辖范围里拿出来,写成同源绝对地址;如果资源和 Worker 的要求冲突到无法共存,就退回「页面和 Worker 都走自有域名,只有纯静态资源走 CDN」。
为什么能解决:同源要求只约束「创建 Worker 的那一下」,不约束 Worker 内部再去加载什么。所以架构上要做的是把必须同源的东西留在同源侧,把可以跨域的东西赶到 CDN 侧。
场景:你把自有域名配好了,但某次分享出去的是平台默认域名,玩家从 xxx.tcloudbaseapp.com 进来,Worker 又挂了。
为什么是坑:这时页面的源是平台默认域名,而 Worker 地址写的是自有域名——方向和坑 3 反过来,一样跨域。只要两个入口都活着,这个问题就会以「偶发」的形式出现,最难查。
怎么解决:把直连入口收回,只保留自有域名一个入口。
为什么能解决:源只剩一个,就不存在「从哪个入口进」的分支。这是所有方案里最省心的一条——能用「只留一个入口」解决的,不要用「兼容两个入口」解决。
下面这张表把「页面入口」和「Worker 路径」两两组合,说明哪种会失败。你可以直接对照自己的配置落在哪一格:
| 页面入口 | Worker 路径 | 结果 | 原因 |
|---|---|---|---|
| 自有域名 https | 自有域名 https | 正常 | 协议、域名、端口全同 |
| 自有域名 https | CDN 域名 https | 失败 | 域名不同 |
| 自有域名 https | 平台默认域名 https | 失败 | 域名不同 |
| 自有域名 http | 自有域名 https | 失败 | 协议不同 |
| 平台默认域名 https | 自有域名 https | 失败 | 域名不同(入口没收回) |
改完配置别靠「感觉好了」。下面这三条命令分别检查入口跳转、Worker 直取、中间层改写,跑完对照输出即可:
# 1. 入口是否还有 302 跳去别的域名(应该看到 200,或者 301 到同一个域名)
curl -I http://www.example.com/
# 2. Worker 脚本是不是 200,且没有跳到别的域名
curl -I https://www.example.com/assets/worker.js
# 3. 响应头里的跨域声明(同源时其实不需要,但有它能排除中间层改写)
curl -I https://www.example.com/assets/worker.js | grep -i access-control
判读标准:第 1 条看到 301 但 Location 是同域名(只换协议)才算对;第 2 条看到 200 且没有 Location;第 3 条即使没有跨域头也不影响同源使用。最后再用浏览器打开页面,控制台应该一条 SecurityError 都没有。
把 Worker 留在自有域名之后,还有一个反向问题:自有域名走的是「全球(不含中国大陆)」的加速区域,国内访客可能比直连慢。下面这张表是同一文件在两个入口的实测对比(同一台机器、同一个文件、各请求多次,取常见值):
| 文件 | 经自有域名(EdgeOne) | 直连 CloudBase 国内 CDN |
|---|---|---|
| 一张 126KB 的图片 | 1.97 秒(偶发 19.9 秒) | 0.22 秒 |
| 17MB 的主包 | 更慢,甚至返回 0 字节 | 正常 |
| 5 个 Worker 脚本分片 | 4.5~16.9 秒 | 0.10~0.15 秒 |
结论不是「放弃自有域名」,而是把两类东西分开:纯静态资源(图片、字体、非 Worker 的脚本)走国内 CDN;必须同源的 Worker 创建入口留在自有域名。Worker 内部要加载的跨域脚本仍然可以从 CDN 取——这正好接上坑 2 里那条「importScripts 可以跨域」的规则。
当前这套做法的边界:
这些内容来自一个真实项目上线自有域名后的连续排查,前后处理了四类同源问题,跨度约一周。文中所有耗时数字都是同一台机器上对同一个文件、两个入口各请求多次测出来的,不是估算;而「哪些组合会失败」则是先在浏览器复现、再去配置里逐条比对得出的。最后收敛成的四条规则,后来每次改部署配置都会照着走一遍。