Serverless迁移S3 Bucket引用至Resources遇已存在错误的解决方法

这个场景我之前帮团队处理过——当你把S3 Bucket从函数事件的直接引用改成Resources段管理时，遇到已有Bucket的环境报错，又不想用existing:true（因为部分环境还没创建Bucket），核心思路是用CloudFormation条件判断来区分两种部署场景：

具体实现步骤 #

1. 先定义环境判断条件

在Serverless配置里添加Conditions段，用来识别哪些环境的Bucket已经存在（比如你的dev环境）：

service: your-service-name

provider:
  name: aws
  stage: ${opt:stage, 'dev'}

# 新增条件：判断当前是否是已有Bucket的环境
Conditions:
  HasExistingBucket: !Equals [${self:provider.stage}, 'dev']

2. 分场景配置Bucket资源

在Resources里，通过Condition和Fn::If来决定是创建新Bucket还是接管已有Bucket：

Resources:
  # 为新环境创建Bucket（非dev环境）
  NewBucket:
    Type: AWS::S3::Bucket
    Condition: !Not [HasExistingBucket]
    Properties:
      BucketName: my-bucket-${self:provider.stage}
      # 这里可以添加你需要的精细化配置，比如版本控制、CORS、加密等
      VersioningConfiguration:
        Status: Enabled
    DeletionPolicy: Retain # 防止意外删除Bucket

  # 接管dev环境的现有Bucket
  ExistingDevBucket:
    Type: AWS::S3::Bucket
    Condition: HasExistingBucket
    Properties:
      BucketName: my-bucket-dev # 必须和现有Bucket名称完全一致
      # 这里的属性要和现有Bucket的实际配置完全匹配！比如现有Bucket开了版本控制，这里也要加
      VersioningConfiguration:
        Status: Enabled
    DeletionPolicy: Retain
    UpdateReplacePolicy: Retain # 避免更新时替换现有Bucket

3. 统一在函数事件中引用Bucket

用Fn::If来根据环境选择对应的Bucket，不用改函数逻辑：

functions:
  my-function:
    handler: src/functions/my-function.handler
    events:
      - s3:
          bucket: !If 
            - HasExistingBucket
            - my-bucket-dev
            - ${self:resources.Resources.NewBucket.Properties.BucketName}
          event: s3:ObjectCreated:* # 你的S3事件类型
          # 其他事件配置...

关键注意事项 #

• 属性必须匹配：接管现有Bucket时，ExistingDevBucket的Properties要和Bucket的实际配置完全一致（比如版本控制、加密、CORS规则等），否则CloudFormation会尝试修改资源导致报错。
• 保留策略：DeletionPolicy和UpdateReplacePolicy一定要设为Retain，防止删除栈或更新配置时误删已有Bucket。
• 首次部署到dev：第一次用这个配置部署到dev时，CloudFormation会检测到Bucket已存在且属性匹配，自动将其纳入当前栈的管理，不会抛出“已存在”的报错（前提是这个Bucket没有被其他CloudFormation栈管理）。

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