CloudFormation创建EC2 Key Pair报AlreadyExists错误触发堆栈回滚

报错核心原因是EC2密钥对属于当前账号、当前AWS区域下的全局唯一资源，不是CloudFormation堆栈的私有资源。你模板里写死的密钥对名称MyKeyPair已经在当前区域的账号下存在——不管是之前手动创建的，还是其他堆栈删除后残留的，只要同名，CloudFormation调用AWS API新建资源时就会被拦截，返回AlreadyExists错误，直接触发堆栈回滚。
报错里返回消息显示null是CloudFormation EC2资源处理器的老bug，不用纠结，错误码已经明确指向重名冲突。

官方给的示例只做最基础的语法演示，缺了实际使用必需的配置项：

• 没有做名称唯一性适配，固定用MyKeyPair这种通用名，非常容易和已有资源撞名
• 没配置公钥材料：如果不填PublicKeyMaterial参数，AWS会自动生成新密钥对，但生成的私钥只会在资源第一次创建成功的时候返回一次，没及时保存的话之后再也拿不到，最后创建出来的EC2实例根本无法通过SSH连接
• 没配置生命周期规则，临时测试用的密钥对在堆栈删除后会一直留在账号里，很容易引发后续的重名问题

Resources:
  NewKeyPair:
    Type: 'AWS::EC2::KeyPair'
    DeletionPolicy: Delete # 堆栈删除时同步删掉密钥对，避免残留占用名称
    Properties:
      # 拼接堆栈名称作为密钥对前缀，保证不同堆栈的密钥对名称不重名
      KeyName: !Sub "${AWS::StackName}-ec2-keypair"
      # 替换成你自己本地生成的SSH公钥内容，无需等待AWS返回私钥
      PublicKeyMaterial: "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQxxxxxx your_email@example.com"
      KeyType: rsa
      Tags:
        - Key: Env
          Value: Test
  Ec2Instance:
    Type: 'AWS::EC2::Instance'
    Properties:
      ImageId: ami-02b92c281a4d3dc79
      KeyName: !Ref NewKeyPair

• 如果你本来就是想用已经存在的MyKeyPair密钥对，直接删掉模板里的NewKeyPair资源定义，把EC2实例的KeyName字段直接填成已有的密钥对名称就行，不用重复创建
• 如果一定要用MyKeyPair这个名字，也不想删除原有密钥对，可以走CloudFormation的资源导入流程，把已有密钥对纳入当前堆栈管理，再执行更新就不会报重名错误

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