Ansible剧本出现Malformed Block错误，请求排查解决

1. 确认顶层YAML结构 #

Ansible剧本必须以列表形式开头，每个play需以-作为起始标记。如果整个剧本没有顶层的-，会被识别为单个字典块，直接触发Malformed Block错误。

正确的顶层结构示例：

- name: 收集yum历史日志
  hosts: all
  tasks:
    - name: 拉取yum日志文件
      fetch:
        src: /var/log/yum.log
        dest: /tmp/yum_logs/{{ inventory_hostname }}/
        flat: yes

2. 验证缩进一致性 #

• 全程使用空格缩进，绝对不能混合Tab键，且同层级元素的缩进数量必须完全一致（建议统一用2或4个空格）。
• 用yamllint工具做语法校验，命令：yamllint your_playbook.yml，能快速定位缩进不规范、层级错乱的问题。

错误缩进示例（需避免）：

tasks:
  - name: 拉取yum日志文件
      fetch:  # 此处缩进比上一行多，层级错误
        src: /var/log/yum.log

3. 排查特殊字符与语法问题 #

• 确保所有键值对的:后必须跟空格，比如name: 拉取日志而非name:拉取日志。
• 包含变量或特殊字符的字符串，若出现解析异常，可尝试用引号包裹，比如dest: "/tmp/yum_logs/{{ inventory_hostname }}/"。
• 检查是否存在未闭合的引号、注释符号（#）使用不当等问题。

4. 拆分剧本逐步测试 #

• 先编写最小可运行单元测试剧本，比如：

- name: 基础功能测试
  hosts: localhost
  tasks:
    - name: 输出测试信息
      debug:
        msg: "测试通过"

• 运行ansible-playbook --syntax-check test_playbook.yml确认无语法错误后，再逐步添加原剧本的任务模块，每添加一部分就做一次语法检查，定位出错的段落。

5. 检查文件编码与隐藏字符 #

• 用cat -A your_playbook.yml查看文件，确认是否存在Windows换行符（^M）或其他隐藏控制字符，这类字符会导致YAML解析失败。
• 确保文件采用UTF-8编码，且无BOM头。

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