CloudFront 405错误未显示自定义错误页面

看起来你遇到了CloudFront自定义错误页面在405场景下不生效的问题，我来帮你梳理几个可能的原因和对应的排查步骤：

可能的原因及排查方向 #

1. CloudFront默认拦截了TRACE方法 #

CloudFront默认会拒绝TRACE请求，这种情况下它会直接返回默认的405错误页面，不会触发你配置的自定义错误逻辑。你需要先确认是否在分发的行为设置中允许了TRACE方法：

• 进入CloudFront控制台，找到你的分发，切换到「Behaviors」标签
• 选中对应的行为规则，点击「Edit」编辑
• 在「Allowed HTTP Methods」选项中，确认是否包含TRACE方法（可以选择包含所有方法的选项：GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS, TRACE）
• 保存配置后，等待CloudFront分发部署完成（通常需要几分钟），再用Postman测试TRACE请求

2. CloudFront无法访问S3上的自定义错误页面 #

你的自定义页面放在S3的private/index.html，如果CloudFront没有权限读取这个文件，就无法返回自定义页面，只能显示默认错误：

• 如果你使用了Origin Access Control (OAC)，检查OAC是否已经关联到你的S3源，并且S3桶策略中添加了允许OAC访问该对象的规则
• 如果你用的是旧版的Origin Access Identity (OAI)，同样要确认桶策略允许OAI读取private/index.html对象
• 另外，检查该文件的Content-Type是否设置为text/html，避免浏览器无法正确解析页面

3. 自定义错误页面的配置细节有误 #

可能是405的错误配置存在疏漏，你可以再核对一遍：

• 进入CloudFront分发的「Error Pages」标签，找到405的配置项
• 确认「Customize Error Response」设置为Yes
• 「Response Page Path」要以斜杠开头，也就是/private/index.html（CloudFront要求路径必须带开头的斜杠）
• 「HTTP Response Code」选择405（保持原错误状态码，这样客户端能正确识别错误类型）

4. CloudFront缓存干扰 #

有时候旧的错误响应会被缓存，导致新配置不生效：

• 进入CloudFront控制台的「Invalidations」标签
• 创建一个新的失效请求，路径填写/*，触发全量缓存清除
• 等待失效完成（通常几分钟）后，再用TRACE方法测试

按照上面的步骤逐一排查，应该能解决405自定义错误页面不显示的问题。

备注：内容来源于stack exchange，提问作者AllenC