Ansible执行报错'block'不是Play的有效属性如何解决

block、rescue、always 属于任务级语法结构，并非Play（剧本顶层定义）的合法可配置属性。
Ansible的配置层级有严格的属性边界：

• Play是YAML文件顶层定义的执行单元，合法属性仅包含hosts、name、vars、tasks、handlers等顶层字段，不支持直接配置block
• block是嵌在tasks任务列表里的逻辑块，用来包裹一组任务实现统一的错误处理（配合rescue/always），只能作为tasks列表下的单个条目存在

你当前触发报错的原因，是把任务级的block结构放到了Play的层级下被解析，Ansible扫描到顶层的block字段时，判定它不属于Play的合法属性，直接抛出报错。

场景1：当前文件是角色内的任务片段（路径为tasks/get_diagnostic.yml） #

这类文件本身是纯任务列表，会被主Play通过include_tasks、角色加载的方式引入，不需要额外补全Play层定义，保持当前YAML结构合法即可：

---
- name: Get diagnostic info block
  block:
    - name: Get top process diagnostic info
      script: library/diag_top_processes.ps1
      failed_when: false
      changed_when: false
      register: diag_top_proc_out

    - name: Get memory and pagefile usage diagnostic info
      script: library/diag_memory_and_pagefile.ps1
      failed_when: false
      changed_when: false
      register: diag_mem_page_out

    - name: Get CPU info
      script: library/diag_cpu_info.ps1
      failed_when: false
      changed_when: false
      register: diag_cpu_info_out

    - name: Init diag message
      set_fact:
        diag_msg: "Diagnostic information:"
        proc_info: "{{ diag_top_proc_out.stdout|regex_replace('\r\n|\n|\r', '') }}"
        cpu_info: "{{ diag_cpu_info_out.stdout_lines | join(' ') }}"

    - name: Add top process info
      set_fact:
        diag_msg: "{{ [diag_msg, proc_info] | join(' ') }}"

    - name: Add memory info
      set_fact:
        diag_msg: "{{ [diag_msg, diag_mem_page_out.stdout_lines[0]] | join(' ') }}"

    - name: Add CPU info
      set_fact:
        diag_msg: "{{ [diag_msg, cpu_info] | join(' ') }}"

  rescue:
    - name: Diag info collection failed, setup variable
      set_fact:
        diag_failed: true

注意：必须确认这个文件是被引入到另一个完整Play的tasks列表下，不能直接用ansible-playbook命令单独执行这个文件，否则会再次触发层级不匹配的报错。

场景2：当前文件是独立执行的完整Playbook #

必须补全Play层的必备属性，把block结构放到tasks字段下，修正后的结构如下：

---
- name: 收集Windows主机诊断信息
  hosts: windows  # 补充Play必备的hosts配置，关联inventory主机组
  tasks:  # 关键：所有任务、block逻辑块必须在tasks字段下
    - name: Get diagnostic info block
      block:
        - name: Get top process diagnostic info
          script: library/diag_top_processes.ps1
          failed_when: false
          changed_when: false
          register: diag_top_proc_out

        - name: Get memory and pagefile usage diagnostic info
          script: library/diag_memory_and_pagefile.ps1
          failed_when: false
          changed_when: false
          register: diag_mem_page_out

        - name: Get CPU info
          script: library/diag_cpu_info.ps1
          failed_when: false
          changed_when: false
          register: diag_cpu_info_out

        - name: Init diag message
          set_fact:
            diag_msg: "Diagnostic information:"
            proc_info: "{{ diag_top_proc_out.stdout|regex_replace('\r\n|\n|\r', '') }}"
            cpu_info: "{{ diag_cpu_info_out.stdout_lines | join(' ') }}"

        - name: Add top process info
          set_fact:
            diag_msg: "{{ [diag_msg, proc_info] | join(' ') }}"

        - name: Add memory info
          set_fact:
            diag_msg: "{{ [diag_msg, diag_mem_page_out.stdout_lines[0]] | join(' ') }}"

        - name: Add CPU info
          set_fact:
            diag_msg: "{{ [diag_msg, cpu_info] | join(' ') }}"

      rescue:
        - name: Diag info collection failed, setup variable
          set_fact:
            diag_failed: true

• 遇到“属性不是有效配置”类报错，优先对应查Ansible两个层级的合法属性范围：Play层属性、Task层属性完全独立，不要跨层混用语法
• 提前明确YAML文件的定位：是独立Playbook、还是角色任务片段、还是变量/模板文件，不同定位的结构要求完全不同
• 报错附带的provided hosts list is empty警告和block报错无直接关联，只要在执行命令时指定正确的inventory主机列表，该警告就会消失

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