AWS SAM部署报错：dev阶段已存在问题求助

核心原因 #

你遇到的dev already exists错误，根源是重复定义了API Gateway的阶段部署：

• 在AWS::Serverless::Api中指定StageName: dev后，SAM框架会自动为该API创建对应的部署（Deployment）和阶段（Stage）资源。
• 同时手动添加AWS::ApiGateway::Deployment资源并指定StageName: dev，会导致CloudFormation尝试创建两个同名的dev阶段，触发冲突报错。

另外模板里还有几处硬编码和路径配置问题，会引发后续隐患，一并修复。

具体修复步骤 #

1. 删除重复的部署资源 #

直接移除模板中的MyAPIDeployment部分，SAM会自动管理API的部署和阶段，无需手动定义。

2. 修正硬编码的资源引用 #

把Swagger里的固定值替换为动态引用，避免资源变更后出现配置失效：

• 将Swagger中的host字段替换为!Sub "${MyAPI}.execute-api.ap-south-1.amazonaws.com"，自动关联API的域名
• 将Lambda集成的uri替换为!Sub "arn:aws:apigateway:ap-south-1:lambda:path/2015-03-31/functions/${MyFunction.Arn}/invocations"，动态获取Lambda函数的ARN

3. 修正API路径配置 #

你的MyAPI已经设置了basePath: /dev，所以Lambda Events中的Path应该设为/，否则最终访问路径会变成/dev/dev，不符合预期。

4. 清理栈残留资源（可选） #

如果之前的部署已经在CloudFormation栈中留下冲突的资源记录：

• 先尝试用修正后的模板重新部署
• 若仍报错，可删除整个CloudFormation栈（注意备份Lambda代码等资源）后重新部署

修正后的完整模板 #

Resources:
  MyFunction: 
    Type: AWS::Serverless::Function 
    Properties:
      FunctionName : MyFunctionName
      CodeUri: MyFunctionName/
      Handler: app.lambda_handler
      Role: MyRole
      Tags: 
        env : dev
      Architectures:
        - x86_64
      Events:
        MyAPI:
          Type: Api
          Properties:
            Path: /
            Method: POST
            RestApiId: 
              Ref: MyAPI
      VpcConfig:
        SecurityGroupIds: <sec grp id>
        SubnetIds: <subnet id>

  MyAPI: 
    Type: AWS::Serverless::Api
    Properties:
      DefinitionBody: 
        swagger: 2.0
        info:
          title: MyAPIName
        host: !Sub "${MyAPI}.execute-api.ap-south-1.amazonaws.com"
        schemes:
          - https        
        basePath: /dev
        paths:
          /:
            post:
              responses: {}
              x-amazon-apigateway-integration:
                type: "aws_proxy"
                httpMethod: "POST"
                uri: !Sub "arn:aws:apigateway:ap-south-1:lambda:path/2015-03-31/functions/${MyFunction.Arn}/invocations"
                responses:
                  default:
                    statusCode: "200"
                passthroughBehavior: "when_no_match"
                contentHandling: "CONVERT_TO_TEXT"      
        x-amazon-apigateway-policy:
          Version: '2012-10-17'
          Statement:
          - Effect: Deny
            Principal: "*"
            Action: execute-api:Invoke
            Resource: "*"
            Condition:
              StringNotEquals:
                aws:sourceVpce:
                - vpce-xxxxxx
          - Effect: Allow
            Principal: "*"
            Action: execute-api:Invoke
            Resource: "*"
      EndpointConfiguration:
        Type: PRIVATE
      StageName: dev

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