Serverless Framework指定S3桶名并自动创建部署报错的解决方法

错误原因 #

你遇到的报错是因为Serverless Framework的部署流程逻辑：在启动CloudFormation部署前，会先检查provider.deploymentBucket.name指定的桶是否存在。而你在resources中定义的S3桶是由CloudFormation在后续部署步骤中创建的，桶检查步骤早于桶创建步骤，因此会抛出"桶不存在"的错误。

解决方案 #

方法一：使用Serverless Deployment Bucket插件（推荐，全自动化） #

这个插件会自动在部署前检查指定名称的桶是否存在，不存在则创建，完美匹配你的需求。

1. 安装插件

npm install serverless-deployment-bucket --save-dev

2. 修改serverless.yml配置
   移除原配置中provider.deploymentBucket和resources里的桶定义，替换为以下内容：

plugins:
  - serverless-deployment-bucket

provider:
  name: aws
  runtime: nodejs16.x

custom:
  deploymentBucket:
    name: myS3Bucket
    # 可选：添加桶的额外配置，比如版本控制、加密
    versioning: true
    encryption: AES256

3. 执行部署

serverless deploy

插件会自动处理桶的创建和部署桶的指定，无需额外操作。

方法二：分阶段部署（无插件） #

如果不想使用插件，可以分两步手动完成桶的创建和后续部署：

1. 创建临时配置文件create-bucket.yml，仅定义S3桶：

provider:
  name: aws
  runtime: nodejs16.x

resources:
  Resources:
    MyLambdaBucket:
      Type: AWS::S3::Bucket
      Properties:
        BucketName: myS3Bucket

2. 执行部署创建桶：

serverless deploy --config create-bucket.yml

3. 恢复原serverless.yml配置，再次执行部署：

serverless deploy

此时桶已存在，部署流程会正常执行。

方法三：跳过桶存在性检查（不推荐） #

可以通过配置跳过Serverless的桶检查步骤，但存在风险（比如桶创建失败会导致后续部署出错），仅作参考：

provider:
  name: aws
  runtime: nodejs16.x
  deploymentBucket:
    name: myS3Bucket
    skipDeploymentBucketValidation: true
  resources:
    Resources:
      MyLambdaBucket:
        Type: AWS::S3::Bucket
        Properties:
          BucketName: ${self.provider.deploymentBucket.name}

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