如何修复CloudFormation YAML映射中的无效属性问题

以下是针对你的问题的排查和解决步骤：

1. 校验Mappings的YAML格式与层级 #

E7001错误常因映射结构解析失败引发，需确保GlueUsageProfileMappings的缩进、层级完全符合YAML规范：

Mappings:
  GlueUsageProfileMappings:
    dev:
      DevRole: arn:aws:iam::123456789012:role/dev-glue-role
      AdminRole: arn:aws:iam::123456789012:role/dev-admin-role
      DataEngineerRole: arn:aws:iam::123456789012:role/dev-dataeng-role
    preprod:
      DevRole: arn:aws:iam::123456789012:role/preprod-glue-role
      AdminRole: arn:aws:iam::123456789012:role/preprod-admin-role
      DataEngineerRole: arn:aws:iam::123456789012:role/preprod-dataeng-role
    prod:
      DevRole: arn:aws:iam::123456789012:role/prod-glue-role
      AdminRole: arn:aws:iam::123456789012:role/prod-admin-role
      DataEngineerRole: arn:aws:iam::123456789012:role/prod-dataeng-role

• 禁止混用空格与制表符缩进，所有层级缩进保持一致（建议用2或4个空格）。
• 确保DevRole等属性完全嵌套在对应环境（dev/preprod/prod）的节点下，不能出现在Mappings外部的顶级区域。

2. 修正映射引用方式 #

资源中引用Mappings必须使用Fn::FindInMap（或简写!FindInMap），错误的引用方式会被cfn-lint判定为无效属性：

正确引用示例 #

Resources:
  DevGlueJob:
    Type: AWS::Glue::Job
    Properties:
      Role: !FindInMap [GlueUsageProfileMappings, !Ref Environment, DevRole]

常见错误引用 #

• 直接使用!Ref DevRole（未通过映射函数调用）
• 函数参数顺序错误（正确顺序为[映射名称, 环境键, 属性键]）

3. 检查属性名称拼写与大小写 #

CloudFormation对属性名称大小写敏感，确保资源中引用的DevRole、AdminRole、DataEngineerRole与Mappings中定义的名称完全一致（包括大小写）。

4. 更新cfn-lint至最新版本 #

旧版本cfn-lint可能存在规则误判，执行以下命令升级：

pip install --upgrade cfn-lint

升级后重新运行检测命令：

cfn-lint -t ci/*.yml --ignore-checks W1001,W3005,E2010

5. 排查模板其他区域的无效属性 #

检查模板中是否在Resources、Parameters、Outputs、Mappings之外的区域定义了DevRole等属性，这类顶级属性会被cfn-lint判定为无效。

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