使用Serverless Framework部署AWS Lambda时栈名称缺失错误排查与解决

执行部署命令：

sls deploy --stage dev

出现错误：

✖ Error: Please specify a stack name using the --stack option, or persist it in the samconfig.toml file.

上下文信息 #

• serverless.yml已配置service字段：

service: py-events
provider:
  name: aws

• 此前部署正常，近期突然失败
• 未主动使用AWS SAM，但项目中存在template.yaml文件
• 错误源自Serverless Framework的getCfnConfig方法，错误码MISSING_STACK_NAME

已尝试操作 #

• 在serverless.yml的provider段添加stage: dev
• 命令行指定--stack my-stack-dev可临时解决，但希望找到根本原因

问题出在项目中的template.yaml文件：Serverless Framework会自动检测该文件，触发AWS SAM集成模式。在SAM模式下，框架不再使用service字段自动生成CloudFormation栈名称，而是要求显式指定栈名或通过samconfig.toml配置，这就是之前正常、现在报错的核心原因（可能是框架版本更新后增强了SAM检测逻辑，或是项目中新增了template.yaml文件）。

根据是否需要保留template.yaml，选择以下方案：

方案1：移除template.yaml（推荐，若无需SAM） #

删除项目中的template.yaml文件，Serverless会回到原生CloudFormation部署模式，自动以${service}-${stage}（即py-events-dev）作为栈名称，无需额外配置即可正常部署。

方案2：保留template.yaml，显式指定栈名 #

方式1：部署命令中指定 #

每次部署时添加--stack参数，建议沿用service+stage的命名规范：

sls deploy --stage dev --stack py-events-dev

方式2：配置samconfig.toml #

在项目根目录创建samconfig.toml文件，预配置默认栈名称，后续部署无需重复指定：

version = 0.1
[default.dev.deploy]
stack_name = "py-events-dev"

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