AWS CloudFront自定义错误页CSS与图片加载失效问题咨询
快速定位第一步
先打开浏览器开发者工具的「网络」面板,刷新错误页后定位加载失败的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

