You need to enable JavaScript to run this app. AWS CloudFront自定义错误页CSS与图片加载失效问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

AWS CloudFront自定义错误页CSS与图片加载失效问题咨询

CloudFront自定义错误页静态资源加载失效排查方案

快速定位第一步

先打开浏览器开发者工具的「网络」面板,刷新错误页后定位加载失败的CSS/图片资源,确认两个核心信息:

  • 该资源实际发出的完整请求URL
  • 响应状态码(404/403/被浏览器安全策略拦截)
    根据结果对应以下场景排查:

常见原因与对应解决方案(按出现概率排序)

1. 相对路径拼接错误(90%同类问题的根因)

当CloudFront返回自定义错误页时,浏览器地址栏会保留用户原始请求的路径(例如用户访问https://你的域名/不存在的页面时触发错误页,地址栏不会跳转到S3的错误页路径)。
如果错误页HTML内的静态资源使用无开头斜杠的相对路径(例如css/style.css、img/logo.png),浏览器会自动基于当前地址栏路径拼接资源地址,最终生成的请求会变成https://你的域名/不存在的页面/css/style.css,该路径无对应资源,自然加载失败。
解决方案:

  • 把所有静态资源的引用路径改为根相对路径,也就是开头加/,例如将<link rel="stylesheet" href="css/style.css">修改为<link rel="stylesheet" href="/css/style.css">,图片、JS资源同理
  • 也可以直接填写静态资源的完整绝对路径,指向托管静态资源的S3/CloudFront域名

2. 静态资源请求仍指向已关停的EC2主源

如果你的CSS/图片原本配置为从EC2源获取,关停EC2后这类资源的请求会直接返回404。若CloudFront的自定义错误规则只针对HTML错误页的404/5xx状态,不会覆盖静态资源的错误响应,就不会拉取S3上存储的同名静态资源。
解决方案:

  • 检查CloudFront的「缓存行为(Cache Behavior)」规则:配置匹配静态资源路径(例如*.css、*.png)的请求,直接指向S3源,而非EC2主源
  • 无需给静态资源配置自定义错误页,直接将静态资源的源切换到S3即可避免依赖EC2

3. CloudFront边缘节点缓存了旧的404响应

修正路径或源配置后,若之前静态资源加载失败的404响应已经被CloudFront按默认TTL缓存,边缘节点会继续返回旧的404结果,不会拉取新的有效资源。
解决方案:

  • 在CloudFront控制台触发缓存失效操作,清除对应静态资源路径或/*的全量缓存,等待失效完成后再测试
  • 可先给资源加随机查询参数测试(例如https://你的域名/css/style.css?v=123),如果能正常加载则可确认是缓存问题

4. S3静态资源的OAI授权不足

如果错误页HTML能正常加载,但同桶内的CSS/图片返回403,大概率是S3桶策略只给CloudFront的源访问身份(Origin Access Identity, OAI)开放了错误页HTML的读取权限,未覆盖其他静态资源对象。
解决方案:

  • 检查S3桶策略,确认是否允许绑定的CloudFront OAI读取桶内所有静态资源对象,而非仅错误页HTML
  • 可直接临时开放单个静态资源的公网读取权限,测试是否能正常访问,排除S3本身的对象权限问题

5. 浏览器安全策略拦截资源加载

如果网络面板显示资源请求已发出但状态被标记为blocked,则是错误页响应头的Content-Security-Policy(CSP)配置限制了静态资源的加载来源。
解决方案:

  • 查看浏览器控制台的CSP拦截报错信息
  • 修正CSP规则,将静态资源的托管域名加入允许加载的来源列表

内容的提问来源于stack exchange,提问作者Ronald Repolona

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.24 07:36:08