无法将API Gateway配置为私有S3桶代理：通用路由配置失败

核心问题分析 #

你当前仅配置了/index.html的特定路由，但页面内的JS、CSS等静态资源请求的是API Gateway域名下的对应子路径（比如/scripts/app.js），这类路径未匹配到转发S3的路由规则，导致资源加载失败。之前通用路由配置失败，大概率是路由规则、集成设置或权限环节出现疏漏。

正确的通用路由配置步骤 #

1. 创建通配符路由 #

在API Gateway中新增路由/{proxy+}，该规则会匹配所有/开头的多级子路径请求。

2. 配置S3集成规则 #

• 集成类型选择AWS服务，目标服务指定S3；
• 填写S3桶所在区域；
• AWS服务代理路径设为你的桶名称/{proxy}，这里的{proxy}会自动映射路由中/{proxy+}匹配到的路径部分；
• 开启路径覆盖，确保API Gateway将请求路径完整传递给S3。

3. 调整集成请求参数 #

• 在集成请求的HTTP头设置中，添加Host头，值为S3桶的私有访问域名（格式：你的桶名称.s3.区域.amazonaws.com）；
• 内容处理设置为通过（Passthrough），避免API Gateway修改请求体内容。

4. 验证IAM权限 #

确保API Gateway的执行角色拥有S3对象读取权限，策略需包含s3:GetObject，资源指定为桶内所有对象：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::你的桶名称/*"
        }
    ]
}

5. 部署并测试 #

将API部署到指定阶段（如prod），测试访问静态资源路径（比如https://你的API ID.execute-api.区域.amazonaws.com/prod/scripts/app.js），确认资源能正常返回。

额外注意事项 #

• 若S3桶启用了静态网站托管，API Gateway集成需直接指向S3对象存储端点，而非静态网站域名；
• 确保页面内的资源引用为相对路径（如./scripts/app.js），这样请求会自动指向API Gateway域名下的对应路径，而非直接访问S3。

内容的提问来源于stack exchange，提问作者Prakash