GitHub Actions中echo写入app.yaml报缩进错误该如何解决

bad indentation of a sequence entry报错来自YAML解析器，触发原因有两个：

• 你直接通过echo追加的环境变量键值对，没有放在App Engine要求的env_variables顶层配置块下，解析器读到顶层游离的键值对时，和app.yaml原有顶层配置（比如runtime、handlers这类序列项）结构不匹配
• 直接echo输出的内容没有做转义处理，只要secret值里包含冒号、空格、#、引号这类YAML特殊字符，哪怕缩进正确也会触发语法错误。

如果暂时要保留echo追加的逻辑，按以下规则调整即可：

1. 先在app.yaml末尾写入顶层的env_variables:配置段，不要把变量直接追加到文件根层级
2. 每一行追加的环境变量固定缩进2个空格，和env_variables块形成从属关系
3. 所有变量值用单引号包裹，减少特殊字符导致的语法问题

对应工作流步骤代码：

# 先写入env_variables顶层配置块
- run: echo -e "\nenv_variables:" >> app.yaml
# 逐行追加变量，固定2空格缩进，值用单引号包裹
- run: echo "  MONGO_HOST: '${{ secrets.MONGO_HOST }}'" >> app.yaml
- run: echo "  MONGO_USER: '${{ secrets.MONGO_USER }}'" >> app.yaml
- run: echo "  MONGO_PWD: '${{ secrets.MONGO_PWD }}'" >> app.yaml

注意：这种写法容错率极低，只要secret值本身包含单引号，就会再次破坏YAML语法，仅适合临时调试场景使用。

不要用echo逐行拼接YAML，选以下两种方案之一即可从根源避免格式问题：

• 用YAML专用处理工具写入配置（推荐）
  使用专门的YAML命令行处理工具yq直接修改app.yaml，工具会自动处理缩进、特殊字符转义、结构适配，完全不会出现人工拼接导致的语法错误。只需要在工作流中先安装yq，再执行写入命令即可：

  # 安装yq（主流CI/CD运行环境均支持通过包管理器直接安装）
  - run: [对应运行环境的yq安装命令]
  # 直接写入环境变量配置，自动适配原有文件格式
  - run: yq -i ".env_variables.MONGO_HOST = \"${{ secrets.MONGO_HOST }}\"" app.yaml
  - run: yq -i ".env_variables.MONGO_USER = \"${{ secrets.MONGO_USER }}\"" app.yaml
  - run: yq -i ".env_variables.MONGO_PWD = \"${{ secrets.MONGO_PWD }}\"" app.yaml
  

  这种方式不限制secret的字符内容，不管原有app.yaml用2空格还是4空格缩进，都能生成符合规范的配置。
• 部署时直接传参，不修改app.yaml文件
  不需要把敏感环境变量写入app.yaml，直接在gcloud app deploy命令中通过--set-env-vars参数传入所有敏感值，gcloud会自动将变量注入部署实例，不会把敏感信息写入配置文件，安全性更高，也完全不需要处理YAML格式问题：

  - run: gcloud app deploy --set-env-vars=MONGO_HOST="${{ secrets.MONGO_HOST }}",MONGO_USER="${{ secrets.MONGO_USER }}",MONGO_PWD="${{ secrets.MONGO_PWD }}"
  

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