AWS::Include模板无效错误：部署提示S3内容非合法Yaml/JSON

一、AWS::Include转换失败错误（"Transform AWS::Include failed with: The specified S3 object's content should be valid Yaml/JSON"） #

根源 #

• S3存储的子模板存在YAML/JSON语法错误：比如缩进不规范、引号未闭合、特殊字符未转义、列表/映射结构错误等
• 子模板文件为空、损坏，或者主模板中引用的S3对象路径错误（桶名、对象键拼写错误，S3对象键大小写敏感）
• CloudFormation执行角色没有读取该S3对象的权限，无法获取子模板内容进行解析
• 子模板内容不符合CloudFormation片段要求（比如直接包含AWSTemplateFormatVersion等顶层字段，而非可嵌入的资源/参数/输出片段）

解决方法 #

• 校验子模板语法：将S3中的子模板下载到本地，用yamllint（YAML）或jsonlint（JSON）工具检查语法；也可以用AWS CLI命令aws cloudformation validate-template --template-body file://./sub-template.yaml直接验证
• 核对S3引用路径：确认主模板中AWS::Include的Location参数完全正确，比如s3://my-bucket/cloudfragments/sub-resource.yaml，注意桶名、路径、文件名的大小写
• 配置权限：给CloudFormation执行角色添加s3:GetObject权限，权限范围限定到目标S3对象；不要直接设置对象公开读，避免安全风险
• 调整子模板结构：子模板作为嵌入片段，仅保留可嵌入的资源、参数或输出内容，移除AWSTemplateFormatVersion等顶层模板字段

二、CloudFormation Infrastructure Composer属性/类型缺失错误 #

根源 #

• Infrastructure Composer默认不会自动拉取S3中的子模板内容，无法识别Include引用的资源结构，因此编辑器会判定主模板缺少对应属性和类型定义
• 主模板本身存在语法错误，导致编辑器无法正确解析Include块的位置和作用
• 子模板中的资源定义不符合CloudFormation规范（比如属性名拼写错误、类型不匹配），编辑器预校验时识别到问题

解决方法 #

• 合并模板后导入：将主模板和子模板手动合并为一个完整的CloudFormation模板，再粘贴到Infrastructure Composer中，编辑器就能完整识别所有资源的属性和类型
• 预转换模板：使用cfn-lint工具加上--transform AWS::Include参数，将主模板与子模板预合并，生成完整模板后再导入编辑器
• 修复主模板语法：检查主模板的YAML缩进、Transform块的嵌套位置，确保AWS::Include的使用符合CloudFormation规范（比如在Resources下的资源定义中正确引用）
• 更新编辑器版本：如果使用的是旧版Infrastructure Composer，可能存在Transform支持不足的问题，升级到最新版本即可

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