Serverless新建阶段如何复用已有资源仅部署API网关

Serverless Framework 底层靠 AWS CloudFormation 做资源编排，默认会给每个 stage + region 的部署组合创建一整套独立的资源栈，框架本身没有全局的「发现资源已存在就自动跳过创建」的配置项。你部署FEATURE阶段报资源重复创建的错，核心原因只有两个：要么是你把已经被其他环境/栈创建过的共享资源，又写在了当前FEATURE阶段的资源定义块里；要么是你给资源写死了全局唯一的物理名，不同阶段部署的时候抢同一个资源名，CloudFormation创建资源时检测到重名直接抛错。

• 拆分共享资源栈，不要跨环境重复定义公共资源
  把所有环境共用的资源（比如公共S3存储桶、Cognito用户池、核心业务DynamoDB表）单独抽成一个独立的公共栈部署一次，所有业务环境（包括你要建的FEATURE阶段）的配置里不要再重复定义这些资源，直接通过跨栈输出值、SSM参数存的资源ID或者固定ARN引用就行，从根源上删掉重复创建的逻辑。
• 所有环境独占资源统一加stage后缀避免重名
  每个环境需要独立部署的资源，绝对不要写死固定名称，全部拼接当前stage变量做区分，举个配置例子：

  provider:
    name: aws
    stage: ${opt:stage, 'dev'}
  resources:
    Resources:
      OrderTable:
        Type: AWS::DynamoDB::Table
        Properties:
          TableName: order-table-${self:provider.stage}
          # 部署FEATURE阶段时会自动生成order-table-FEATURE的表名，不会和其他环境重名
          # 其余表配置省略
  

  另外重点检查下Lambda函数、API Gateway、IAM角色、CloudWatch日志组这类框架默认会自动生成的资源，如果你手动改过名称配置，也全部加上stage后缀，避免不同阶段抢同一个资源名。
• 用条件判断控制特定阶段的资源创建
  如果FEATURE阶段就是要复用其他环境已经建好的资源，不需要独立创建，可以给对应资源加CloudFormation条件，部署FEATURE阶段时直接跳过这个资源的创建流程，配置示例：

  conditions:
    needCreateTaskQueue: !Not [!Equals ["${self:provider.stage}", "FEATURE"]]
  resources:
    Resources:
      TaskSQSQueue:
        Type: AWS::SQS::Queue
        Condition: needCreateTaskQueue # 部署FEATURE阶段时会跳过这个队列的创建
        Properties:
          QueueName: task-queue-${self:provider.stage}
  

• 排查无效的硬编码配置
  很多人踩坑是手动给框架自动生成的资源写死了固定名称，比如给API Gateway写了固定的域名、给IAM角色写了固定的角色名，这类硬编码跨阶段部署100%会撞名，删掉这类硬编码配置，让框架自动生成带唯一标识的资源名就能解决问题。

避坑提醒：别想着靠硬编码资源ID让新栈"接管"已经存在的资源，CloudFormation不支持跨栈管理同一个物理资源，这么做只会一直报重名错误。

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