|
|
@@ -0,0 +1,224 @@
|
|
|
+# s3 / CDN CORS 问题:分层诊断报告
|
|
|
+
|
|
|
+> 2026-11-18 实测。**结论:s3 源站配置正确,问题 100% 在 CDN 缓存层。**
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 一、结论先行
|
|
|
+
|
|
|
+| 层 | 状态 | 说明 |
|
|
|
+|---|---|---|
|
|
|
+| **s3 源站 CORS 配置** | ✅ **正确** | 每次回源都返回 `Access-Control-Allow-Origin: *` |
|
|
|
+| **CDN 缓存策略** | ❌ **问题所在** | 缓存了缺 CORS 头的响应,**30 天**不更新 |
|
|
|
+| **CDN 的 `Vary` 头** | ❌ **缺失** | 带/不带 `Origin` 的请求共用同一份缓存 |
|
|
|
+
|
|
|
+**不需要改 s3,只需改 CDN。**
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 二、实测证据
|
|
|
+
|
|
|
+测试对象:`https://s3.fmode.cn/deliverables/agent-node-lj-test/202611/fK9B1XwlCZ/0-mwkkf1pdbl-a.xlsx`
|
|
|
+
|
|
|
+### 证据 1:走缓存的请求(无 CORS 头)
|
|
|
+
|
|
|
+```bash
|
|
|
+curl -I -H "Origin: https://ai.fmode.cn" "$U"
|
|
|
+```
|
|
|
+
|
|
|
+```
|
|
|
+HTTP/1.1 200 OK
|
|
|
+via: ...TCP_HIT... ← 命中 CDN 缓存
|
|
|
+Age: 500
|
|
|
+X-CCDN-CacheTTL: 2592000 ← 缓存 30 天
|
|
|
+(无任何 Access-Control-* 头)
|
|
|
+```
|
|
|
+
|
|
|
+### 证据 2:强制回源的请求(有 CORS 头)
|
|
|
+
|
|
|
+```bash
|
|
|
+curl -I -H "Origin: https://ai.fmode.cn" "$U?nocache=$RANDOM"
|
|
|
+```
|
|
|
+
|
|
|
+```
|
|
|
+HTTP/1.1 200 OK
|
|
|
+via: ...TCP_MISS... ← 回源了
|
|
|
+Age: 1
|
|
|
+Access-Control-Allow-Origin: * ← 源站有!
|
|
|
+Access-Control-Allow-Methods: GET, PUT, POST, HEAD
|
|
|
+Access-Control-Max-Age: 3600
|
|
|
+X-CCDN-Origin-Time: 138
|
|
|
+```
|
|
|
+
|
|
|
+### 证据 3:`Vary` 头缺失导致缓存串用
|
|
|
+
|
|
|
+```bash
|
|
|
+# 第 1 次:无 Origin 请求,回源并缓存
|
|
|
+curl -I "$U?nocache=$RANDOM" → TCP_MISS,Age: 1
|
|
|
+
|
|
|
+# 第 2 次:带 Origin 请求同一 URL
|
|
|
+curl -I -H "Origin: https://ai.fmode.cn" "$U" → TCP_HIT,Age: 519 ← 命中了老的缓存!
|
|
|
+```
|
|
|
+
|
|
|
+**说明 CDN 没有按 `Origin` 分开缓存。**
|
|
|
+
|
|
|
+### 证据 4:源站完全不返回 `Vary`
|
|
|
+
|
|
|
+```bash
|
|
|
+curl -I -H "Origin: https://ai.fmode.cn" "$U?fresh=$RANDOM$RANDOM"
|
|
|
+```
|
|
|
+返回了完整的 CORS 头,但**没有 `Vary: Origin`**。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 三、根因链条
|
|
|
+
|
|
|
+```
|
|
|
+① 历史上某次回源时,源站没返回 CORS 头(或 CDN 缓存时丢掉了)
|
|
|
+ ↓
|
|
|
+② CDN 把这份「无 CORS」响应缓存了 30 天(X-CCDN-CacheTTL: 2592000)
|
|
|
+ ↓
|
|
|
+③ 响应又没有 Vary: Origin,CDN 不区分带/不带 Origin 的请求
|
|
|
+ ↓
|
|
|
+④ 之后所有请求(包括浏览器的跨域 fetch)都拿到这份无 CORS 的缓存
|
|
|
+ ↓
|
|
|
+⑤ 浏览器判定违反 CORS → 拦截 → App/H5 预览失败
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 四、修复方案(按优先级)
|
|
|
+
|
|
|
+### 🔴 P0:立即刷新 CDN 缓存(解决存量文件)
|
|
|
+
|
|
|
+在华为云 CDN 控制台执行**目录刷新**:
|
|
|
+
|
|
|
+```
|
|
|
+URL: https://s3.fmode.cn/deliverables/
|
|
|
+类型: 目录刷新(或「刷新所有」)
|
|
|
+```
|
|
|
+
|
|
|
+> 注意:**只刷新 URL 不够**,需要目录刷新覆盖 `deliverables/` 下所有历史产物。
|
|
|
+
|
|
|
+### 🔴 P0:给 CDN 加 `Vary: Origin`(根治)
|
|
|
+
|
|
|
+**华为云 CDN 控制台 → 域名管理 → 高级配置 → HTTP 响应头配置**
|
|
|
+
|
|
|
+添加:
|
|
|
+```
|
|
|
+Vary: Origin
|
|
|
+```
|
|
|
+
|
|
|
+**为什么必须加**:否则 CDN 仍会把「无 Origin 请求」的响应喂给「带 Origin 请求」,
|
|
|
+下次再有文件回源时照样复现。
|
|
|
+
|
|
|
+### 🟡 P1:缩短 `deliverables/` 的缓存时间
|
|
|
+
|
|
|
+当前 `X-CCDN-CacheTTL: 2592000`(30 天)对**产物文件**太长了。
|
|
|
+
|
|
|
+建议在 CDN 缓存规则里给 `/deliverables/` 单独设:
|
|
|
+```
|
|
|
+Cache-Control: no-cache
|
|
|
+或 max-age=3600(1 小时)
|
|
|
+```
|
|
|
+
|
|
|
+理由:产物文件一旦上传就不变,但**CORS 头可能变**,30 天缓存会让问题持续很久。
|
|
|
+
|
|
|
+### 🟢 P2(可选):源站补 `Vary`
|
|
|
+
|
|
|
+如果华为云 OBS 的 CORS 配置能设 `Vary`,也加上更保险。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 五、这不是 App 端问题
|
|
|
+
|
|
|
+| 疑问 | 回答 |
|
|
|
+|---|---|
|
|
|
+| 「是不是 WebView 导致的?」 | ❌ 不是。线上 Web(`https://ai.fmode.cn`)同样报错,两个 origin 都是跨域 |
|
|
|
+| 「是不是 Capacitor 的问题?」 | ❌ 不是。CORS 是服务器响应头决定的,与客户端框架无关 |
|
|
|
+| 「App 端能修吗?」 | ⚠️ 只能绕(原生下载代理),且只解决 App、H5 仍坏。**根治必须改 CDN** |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 六、验证标准
|
|
|
+
|
|
|
+修复后跑这三条命令,全部有输出即成功:
|
|
|
+
|
|
|
+```bash
|
|
|
+U="https://s3.fmode.cn/deliverables/agent-node-lj-test/202611/1LCA7ahKVQ/1-mwhdlx2fvn-deliverable-20261115-131048.pdf"
|
|
|
+
|
|
|
+# 1. 老文件(走缓存)应有 CORS 头
|
|
|
+curl -sS -I -H "Origin: https://ai.fmode.cn" "$U" | grep -i access-control-allow-origin
|
|
|
+
|
|
|
+# 2. 新文件应有 CORS 头
|
|
|
+curl -sS -I -H "Origin: https://ai.fmode.cn" "https://s3.fmode.cn/deliverables/agent-node-lj-test/202611/fK9B1XwlCZ/0-mwkkf1pdbl-a.xlsx" | grep -i access-control-allow-origin
|
|
|
+
|
|
|
+# 3. 回源时不得出现重复 ACAO 头(应为 1)
|
|
|
+curl -sS -I -H "Origin: https://ai.fmode.cn" "$U?cb=$RANDOM" | grep -ic access-control-allow-origin
|
|
|
+```
|
|
|
+
|
|
|
+真机上点开 PDF / Word / Excel,应能正常渲染。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 七、最终修复(2026-11-18 已生效)
|
|
|
+
|
|
|
+### 实际采用的方案:CDN 边缘注入 CORS 头
|
|
|
+
|
|
|
+原方案的 `Vary: Origin` **在华为云 CDN 上不可行**——响应头配置是白名单,
|
|
|
+`Vary` 不在内,API 直接拒绝:`CDN.0001 unsupported response header : Vary`。
|
|
|
+
|
|
|
+改用**更彻底的方案**:让 CDN 在边缘 serve 时**无条件注入** CORS 头。
|
|
|
+
|
|
|
+| 优势 | 说明 |
|
|
|
+|---|---|
|
|
|
+| 无需刷缓存 | 注入发生在边缘,**历史已缓存的旧文件也会被补上头** |
|
|
|
+| 不受源站影响 | 源站返回什么不影响,CDN 统一覆盖 |
|
|
|
+| 替换而非追加 | 回源自带 CORS 头时是**替换**,不会出现重复头 |
|
|
|
+
|
|
|
+### 已写入配置(domain_id `74495359597444e0ad1be3018fab6cdb`)
|
|
|
+
|
|
|
+```
|
|
|
+Content-Disposition: inline ← 原有,保留
|
|
|
+Access-Control-Allow-Origin: * ← 新增
|
|
|
+Access-Control-Allow-Methods: GET, PUT, POST, HEAD
|
|
|
+Access-Control-Max-Age: 3600
|
|
|
+```
|
|
|
+
|
|
|
+### 独立复核结果(2026-11-18,本地实测)
|
|
|
+
|
|
|
+| 验证项 | 结果 |
|
|
|
+|---|---|
|
|
|
+| 之前失败的 PDF(`Age: 249380`,缓存命中) | ✅ `Access-Control-Allow-Origin: *` |
|
|
|
+| 之前失败的 xlsx(`Age: 56567`) | ✅ 有 CORS 头 |
|
|
|
+| 之前失败的 html(`Age: 249423`) | ✅ 有 CORS 头 |
|
|
|
+| 回源请求(`?cb=随机`)ACAO 头个数 | ✅ **1**(无重复) |
|
|
|
+| 换 Origin 为 `https://localhost` | ✅ 生效 |
|
|
|
+| 不带 Origin 的请求 | ✅ 也带头 |
|
|
|
+| **真机内 `fetch` PDF** | ✅ **成功,3,607 字节** |
|
|
|
+| **真机内 pdfjs 解析 PDF** | ✅ **1 页 / 595×842 / 125ms / v4.10.38** |
|
|
|
+| 真机内 fetch xlsx / html / docx | ✅ 5,102 / 2,048 / 37,341 字节 |
|
|
|
+
|
|
|
+### 缓存 TTL 未改动(维持 30 天)
|
|
|
+
|
|
|
+理由:CORS 头由 CDN 无条件注入,不会因缓存而缺失;产物 key 带随机串,
|
|
|
+覆盖极罕见。缩短 TTL 只增加回源量,无收益。
|
|
|
+
|
|
|
+### 回滚命令
|
|
|
+
|
|
|
+```bash
|
|
|
+node cdn-ops.js del-hdr 74495359597444e0ad1be3018fab6cdb \
|
|
|
+ Access-Control-Allow-Origin Access-Control-Allow-Methods Access-Control-Max-Age
|
|
|
+```
|
|
|
+
|
|
|
+### ⚠️ 遗留小问题(不影响公开文件读取)
|
|
|
+
|
|
|
+预检响应里上游仍带 `Access-Control-Allow-Credentials: true`,
|
|
|
+与 `ACAO: *` 是矛盾组合——只影响**带凭据**的请求。
|
|
|
+本项目读公开文件不带凭据,不受影响;将来若需带凭据,应改为回显具体 Origin。
|
|
|
+
|
|
|
+### 方法论沉淀
|
|
|
+
|
|
|
+- 华为云 CDN 不支持 `Vary`,响应头配置仅白名单内可选
|
|
|
+- 响应头配置是**整体覆盖**,不是追加(修改时要带上原有项)
|
|
|
+- 同类扫描:14 个域名中 s3 是唯一漏配的,现已对齐
|