如何在SAM模板中引用环境变量值作为S3存储桶名称？

你不需要尝试从Lambda的环境变量反向读取桶名，CloudFormation/SAM模板在部署阶段就需要解析S3桶的取值完成事件关联，而环境变量是部署完成后才注入Lambda运行时的，部署阶段无法读取。你只需要让环境变量的BUCKET_NAME和事件配置的Bucket字段引用同一个取值源，就能保证两者一致。

具体实现方案 #

分两种常见场景给出可直接使用的模板：

场景1：S3桶在当前模板内创建 #

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Resources:
  # 模板内定义S3存储桶
  TargetS3Bucket:
    Type: AWS::S3::Bucket

  CreateThumbnail:
    Type: AWS::Serverless::Function
    Properties:
      Handler: handler # 替换为实际处理函数入口，比如index.handler
      Runtime: runtime # 替换为实际运行时，比如python3.10、nodejs18.x
      Timeout: 60
      Policies: 
        - AWSLambdaExecute
        # 额外添加S3桶操作权限，避免运行时报错
        - S3CrudPolicy:
            BucketName: !Ref TargetS3Bucket
      Environment:
        Variables:
          # 和事件配置引用同一个桶资源，保证取值一致
          BUCKET_NAME: !Ref TargetS3Bucket

      Events:
        CreateThumbnailEvent:
          Type: S3
          Properties:
            # 直接引用S3桶的逻辑名即可，SAM会自动配置事件触发规则和权限
            Bucket: !Ref TargetS3Bucket
            Events: s3:ObjectCreated:*

场景2：S3桶是预先创建的、不在当前模板内 #

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Parameters:
  # 定义参数接收外部传入的已存在桶名
  ExistingS3Bucket:
    Type: String
    Description: 预先创建的S3存储桶名称
Resources:
  CreateThumbnail:
    Type: AWS::Serverless::Function
    Properties:
      Handler: handler
      Runtime: runtime
      Timeout: 60
      Policies: 
        - AWSLambdaExecute
        - S3CrudPolicy:
            BucketName: !Ref ExistingS3Bucket
      Environment:
        Variables:
          BUCKET_NAME: !Ref ExistingS3Bucket

      Events:
        CreateThumbnailEvent:
          Type: S3
          Properties:
            Bucket: !Ref ExistingS3Bucket
            Events: s3:ObjectCreated:*

注意事项 #

• 如果使用预先创建的S3桶，需要确保部署CloudFormation的角色有该桶的事件配置权限，否则会部署失败。
• SAM会自动为Lambda添加S3事件触发的权限，不需要手动额外配置权限策略。

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