网页能打开、Worker 却起不来:自有域名的四个同源坑 | 杨元超的世界

导读:约 12 分钟读完;需要你部署过静态站点、会在命令行跑 curl;没配过 CDN 也能跟,第 4 节会把用到的两个云服务先讲清。

1 这篇写给谁

这篇写给「页面已经上线、但浏览器里有一类功能静默失效」的人。最典型的症状是:网页能打开、图片能显示,但依赖多线程的功能全部失效——比如游戏里的计算模块一个都没起来,控制台里只有一行 SecurityError: Failed to construct 'Worker'。读完你能带走四条配置规则、一张「什么组合会失败」的对照表,和三条能直接跑的验证命令。

读者 带走什么 拿它做什么 从哪节开始读
刚把站点绑到自有域名的人 四条入口与路径规则 按顺序检查自己的域名、协议、Worker 路径三处配置 5
用 CDN + 对象存储/静态托管部署的人 「回源重写」这套零代码方案 不用写跳转页,也不用云函数,就把地址栏固定成自有域名 5
遇到 Worker/SharedWorker 起不来的人 三条硬限制 + 验证命令 用 curl -I 和浏览器控制台两条线确认是不是跨域 6、8

不适合谁:只想搞懂 CDN 原理、不打算动手改配置的读者。

2 这篇讲什么

一句话:把站点搬到自有域名,本质上是在挪「源」(origin),而 Worker 对「源」的要求比普通请求严格得多。普通资源跨域,加个跨域响应头就能用;Worker 不行,它必须在创建那一刻就与页面同源。

下面这张表是全文导航,每行说清这一节解决什么问题:

小节 讲什么 解决什么问题
3 现象:页面正常、Worker 起不来 先确认你遇到的是不是同一类
4 环境准备 + 三个概念 装好验证工具,建立「源」的概念
5 为什么要自有域名 + 完整配置顺序 知道每一步为什么存在、好处是什么
6 四个坑,逐个拆 每个坑的现象、成因、修法
7 五种配置组合对照表 对照自己的配置会落在哪一格
8 判据:三条命令 改完怎么确认真的好了
9 性能上的取舍 同源不等于最快,资源该走哪条路

3 现象:页面能开,Worker 就是起不来

先说现场。站点已经绑好自有域名,浏览器打开一切正常: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 的脚本地址,和页面的源不是同一个。难的是找出「为什么它们不是同一个」——因为配置里明明写着同一个域名。

4 环境准备与三个概念

配之前先备好三样:域名解析控制台、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。

5 为什么要自有域名,以及不备案怎么做到的

分三段说清,因为这三件事经常被混成一句「配个域名就行」。

为什么要做:不绑域名,站点只能通过平台默认域名访问,有三个具体麻烦。分享出去的链接是一串随机字符;搜索引擎会把默认域名和以后的自有域名当成两个地址;哪天换托管平台,所有链接全断。

怎么做:按顺序四步。

  1. 把自有域名的解析指到 EdgeOne。
  2. 在 EdgeOne 配源站,源站地址填 CloudBase 的默认域名——这里是「回源」:边缘节点没缓存时,去源站取文件。
  3. 配一条回源路径重写:^/(.*)$ → /gts_play_pro/dist/$1。意思是访客请求 https://www.example.com/blog/x/,EdgeOne 到源站取的是 /gts_play_pro/dist/blog/x/。这样既保持了地址栏不变,又不用改构建产物的任何一行路径。
  4. 配一条强制 HTTPS:HTTP 请求直接 301 到 HTTPS。

有什么好处:地址栏从头到尾是自有域名,分享链接稳定、搜索引擎只记一个地址;换托管平台时只改源站,对外链接不用动;全程零代码,没有跳转页、也没有云函数。

这里有个容易走偏的替代方案:不用回源重写,改成「让平台在访问时 302 到默认域名」。它也能打开页面,但地址栏会跳成 xxx.tcloudbaseapp.com,前面说的三个好处全没了。回源重写之所以是首选,是因为它在服务端完成改写,访客永远看不到第二个域名。换别家 CDN 也成立——关键不是哪家厂商,而是入口层必须同时支持「改写回源路径」和「强制 HTTPS」这两件事。

6 四个坑,逐个拆

坑 1:http 和 https 是两个源

场景:域名刚解析好,你用 http:// 打开过一次,一切正常;第二天用 https:// 打开,Worker 起不来了。

为什么是坑:页面是 https、Worker 脚本地址是 http(或者反过来)时,协议不同就是不同源。更隐蔽的是「协议相对地址」——写成 //www.example.com/x.js 时,浏览器会继承当前页面的协议,页面还是 http 时它还是 http,看起来什么都没错。

怎么解决:在入口层强制 HTTPS,用 301 把 http 请求永久转到 https,而不是在页面里写跳转脚本。页面层跳转只能救「已经加载了页面」的情况,救不了 Worker 构造那一刻。

为什么能解决:所有入口最后都只剩一个协议,源的三要素里协议这一项固定了。实测中,玩家在 Vivo 手机、Chromium 146 上就是被这一条卡住,控制台报 SecurityError。

坑 2:Worker 的三条硬限制

场景:你确认页面和 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 这一步不能跨域,两件事不能互相替代。这一点决定了后面的架构取舍。

坑 3:base 标签把你带到别的源

场景:为了让静态资源走更快的 CDN,你给页面加了 base 指向 CDN 域名,同时把资源基址写成 CDN 的绝对地址。资源确实快了,Worker 却全灭。

为什么是坑:base 改变的是页面内相对路径的解析基准。Worker 路径写成 /assets/worker.js 时,浏览器按 base 的源展开,真实地址变成了 CDN 域名——于是「页面在自有域名、Worker 在 CDN 域名」,又跨域了。

怎么解决:把 Worker 路径从 base 的管辖范围里拿出来,写成同源绝对地址;如果资源和 Worker 的要求冲突到无法共存,就退回「页面和 Worker 都走自有域名,只有纯静态资源走 CDN」。

为什么能解决:同源要求只约束「创建 Worker 的那一下」,不约束 Worker 内部再去加载什么。所以架构上要做的是把必须同源的东西留在同源侧,把可以跨域的东西赶到 CDN 侧。

坑 4:CloudBase 默认域名还能直接进

场景:你把自有域名配好了,但某次分享出去的是平台默认域名,玩家从 xxx.tcloudbaseapp.com 进来,Worker 又挂了。

为什么是坑:这时页面的源是平台默认域名,而 Worker 地址写的是自有域名——方向和坑 3 反过来,一样跨域。只要两个入口都活着,这个问题就会以「偶发」的形式出现,最难查。

怎么解决:把直连入口收回,只保留自有域名一个入口。

为什么能解决:源只剩一个,就不存在「从哪个入口进」的分支。这是所有方案里最省心的一条——能用「只留一个入口」解决的,不要用「兼容两个入口」解决。

7 五种配置组合对照表

下面这张表把「页面入口」和「Worker 路径」两两组合,说明哪种会失败。你可以直接对照自己的配置落在哪一格:

页面入口 Worker 路径 结果 原因
自有域名 https 自有域名 https 正常 协议、域名、端口全同
自有域名 https CDN 域名 https 失败 域名不同
自有域名 https 平台默认域名 https 失败 域名不同
自有域名 http 自有域名 https 失败 协议不同
平台默认域名 https 自有域名 https 失败 域名不同(入口没收回)

8 判据:三条命令

改完配置别靠「感觉好了」。下面这三条命令分别检查入口跳转、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 都没有。

9 性能上的取舍:同源不等于最快

把 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 可以跨域」的规则。

10 还能怎么改进

当前这套做法的边界:

这些内容来自哪里

这些内容来自一个真实项目上线自有域名后的连续排查,前后处理了四类同源问题,跨度约一周。文中所有耗时数字都是同一台机器上对同一个文件、两个入口各请求多次测出来的,不是估算;而「哪些组合会失败」则是先在浏览器复现、再去配置里逐条比对得出的。最后收敛成的四条规则,后来每次改部署配置都会照着走一遍。

相关文章