为何部分AWS S3请求因CORS错误失败？求排查与解决方法

1. S3重定向触发的CORS失效 #

状态码307表示临时重定向，部分用户的请求可能触发了S3的重定向逻辑：

• 比如请求的对象存储在其他区域、对象键包含特殊字符导致自动编码重定向，或者使用了生成逻辑有问题的预签名URL。
• 重定向后的请求如果没有正确携带CORS头，就会触发缺失Access-Control-Allow-Origin的错误。

解决方法：

• 检查存储桶是否设置了静态网站托管的重定向规则，确认对象是否被移动到其他存储桶/区域。
• 验证预签名URL的生成逻辑：确保使用正确的存储桶区域，对对象键进行URL编码，避免触发重定向。

2. 浏览器或CDN缓存旧响应 #

部分用户的浏览器缓存了之前未配置CORS头的响应，或者前端使用的CDN缓存了不符合要求的响应，导致后续请求直接读取缓存而报错。

解决方法：

• 指导用户清除浏览器缓存后重试，或者在前端请求中添加Cache-Control: no-cache头，强制浏览器拉取最新响应。
• 若使用CDN，检查缓存规则：确保CORS相关响应头被正确缓存，或缩短PDF资源的缓存有效期。

3. S3 CORS配置未完全同步 #

虽然你的CORS配置看似正确，但S3的配置变更存在区域同步延迟，部分节点可能未更新最新规则；或者存储桶的Bucket Policy限制了CORS头的返回。

解决方法：

• 重新保存S3 CORS配置，等待10-15分钟让配置同步到所有节点。
• 检查Bucket Policy：确保没有拒绝携带Origin头的请求，也没有覆盖CORS配置的规则。

4. 特殊浏览器/网络环境的干扰 #

部分用户可能使用旧版本浏览器，或处于企业内网等有代理/防火墙的环境，这些环境可能修改请求头或拦截响应头，导致CORS头缺失。

解决方法：

• 建议用户升级浏览器至最新版本，或在无代理的网络环境下测试。
• 排查请求在特殊环境下的实际头信息：比如Origin头是否被代理替换，导致S3无法匹配CORS规则。

5. react-pdf-viewer的特殊请求逻辑 #

react-pdf-viewer可能在某些场景下发起与手动测试不同的请求（比如分块加载的Range头请求），S3对这类请求的CORS处理可能有特殊要求，即使配置了AllowedHeaders: "*"，也可能存在校验差异。

解决方法：

• 检查失败请求是否带有Range头，在CORS配置的ExposeHeaders中添加Content-Range，确保响应头可被前端读取。
• 查看react-pdf-viewer文档，确认是否开启了分块加载等特殊配置，调整相关参数避免触发异常请求。

内容的提问来源于stack exchange，提问作者hd-93