Copilot部署环境时YAML格式错误排查修复求助

核心排查与修复步骤 #

单个参数正常、多参数触发「YAML not well-formed」，几乎都是addons.parameters.yml的语法问题，按以下顺序排查：

1. 处理参数值的特殊字符 #

如果参数值包含冒号（:）、引号、换行或空格开头的内容，必须用引号包裹，或者用YAML块标量语法：

• 错误示例：

  DB_PASSWORD: my:p@ssword  # 冒号会被YAML误解析为键值分隔符
  

• 正确示例：

  DB_PASSWORD: "my:p@ssword"
  # 长字符串用块标量保留格式
  DB_CONN_STRING: |
    postgresql://user:pass@host:5432/db?sslmode=require
  

2. 统一缩进规则 #

YAML对缩进要求极严：必须用空格（禁止混Tab），且所有同级参数的缩进空格数完全一致：

• 错误示例：

  DB_USER: admin
    DB_PORT: 5432  # 缩进比上一行多，属于语法错误
  

• 正确示例：

  DB_USER: admin
  DB_PORT: 5432
  

3. 校验参数键名合法性 #

参数键名不能含空格、@、#等特殊字符，建议用蛇形命名（比如DB_SUBNET_GROUP），同时要和template.yml中定义的参数名完全匹配（大小写敏感）。

4. 用工具批量检查语法 #

用yamllint命令本地校验，直接定位错误行：

yamllint environments/addons/addons.parameters.yml

工具会明确指出哪一行存在格式问题，比如未闭合的引号、错误缩进等。

5. 逐步添加参数调试 #

如果以上方法没找到问题，就从单个正常参数开始，逐个添加其他参数，每次添加后执行copilot env deploy，找到触发错误的具体参数，针对性排查该参数的格式。

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