如何在API Gateway集成路径覆盖中用Stage Variable指定S3桶名

核心问题修正 #

你之前的写法错误在于变量名的复数形式——正确语法是${stageVariables.你的变量名}，不是单数的stageVariable。比如你在Stage里设置的变量名为bucket，路径覆盖应该写${stageVariables.bucket}/{key}。

具体配置步骤 #

• 确认Stage Variable名称：检查你在对应Stage中设置的存储桶变量名，确保拼写和后续引用一致
• 配置集成请求路径：
  1. 进入API Gateway目标方法的集成请求标签页
  2. 在S3集成的路径覆盖（或HTTP请求路径）中，直接填写${stageVariables.你的变量名}/{key}，不要添加任何引号
• 调整权限策略：API Gateway的执行角色需要具备访问动态存储桶的权限，策略示例如下：

  {
    "Version": "2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Action": ["s3:GetObject", "s3:PutObject"],
        "Resource": "arn:aws:s3:::*/*"
      }
    ]
  }
  

  （如果需要更严格的权限，可以指定具体桶的ARN模式，比如arn:aws:s3:::your-bucket-prefix-*/*）
• 正确测试：不要在API Gateway的测试控制台直接测试（默认不带Stage Variable），需部署到对应Stage后通过访问URL测试，或在测试控制台手动添加Stage Variable参数

常见坑点 #

• 单数/复数混淆：必须用stageVariables（复数），单数写法不会被系统识别
• 多余引号：加引号会被解析为路径的一部分，导致S3尝试访问带引号的桶名，必然失败
• 集成类型错误：确保选择的是S3集成，而非HTTP集成，两种集成的路径变量解析逻辑不同

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