Ansible：基于循环项键值跳过项时任务全跳过的异常问题

调试Ansible循环与条件跳过逻辑时遇到异常：初始playbook运行正常，取消注释某一循环项后，预期仅跳过该循环项，却出现整个任务被跳过的情况。

初始正常的Playbook #

- name: Play Test
  hosts: all
  gather_facts: false
  vars:
    test1_var: "test1_var"
    test3_var: "{{ default(omit) }}" # omitted
    test4_var: # None
  tasks:
    - block:
      - name: Test some skips in loops
        ansible.builtin.debug:
          msg: "Text:{{ item.text }}|Variable:{{item.variablez}}"
        loop:
          - text: "Should be logged"
            variablez: "{{ test1_var }}"
          - text: "Should be skipped"
          #- text: "Should be skipped"
          #  variablez: "{{ test3_var | default(omit) }}"
          - text: "Should be skipped"
            variablez: "{{ test4_var }}"
        when: item.variablez is defined and item.variablez != None
      delegate_to: localhost

初始运行输出 #

TASK [Test some skips in loops] ******************************************************************************************************************************************************************************************
ok: [mosquitto -> localhost] => (item={'text': 'Should be logged', 'variablez': 'test1_var'}) => 
  msg: Text:Should be logged|Variable:test1_var
skipping: [mosquitto] => (item={'text': 'Should be skipped'}) 
skipping: [mosquitto] => (item={'text': 'Should be skipped', 'variablez': None})

此时第二个循环项因无item.variablez键被跳过，第三项因item.variablez为None被跳过，符合预期。

取消注释后的异常情况 #

取消注释以下循环项：

- text: "Should be skipped"
  variablez: "{{ test3_var | default(omit) }}" # 直接写"{{ default(omit) }}"也会出现相同问题

预期该循环项被跳过，却出现整个任务被跳过：

PLAY [Play Test] *********************************************************************************************************************************************************************************************************

TASK [Test some skips in loops] ******************************************************************************************************************************************************************************************
skipping: [mosquitto]

PLAY RECAP ***************************************************************************************************************************************************************************************************************
mosquitto                  : ok=0    changed=0    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0

核心原因是**omit是Ansible用于移除任务参数的特殊标记，不能直接作为循环项（loop item）的值使用**，结合错误的default(omit)用法，导致了任务被整体跳过的异常：

1. default过滤器的错误用法：直接使用{{ default(omit) }}不符合语法，default过滤器的正确用法是{{ 变量名 | default(默认值) }}，用于变量未定义时返回默认值。直接调用default(omit)会生成无效的特殊值，而非预期的"未定义"状态。
2. omit标记的误用场景：omit的设计目的是在任务参数级别移除某个参数（例如param: "{{ var | default(omit) }}"会在var未定义时移除param参数），但将其作为循环项的字段值时，Ansible会错误处理整个循环项结构：
   • 当循环项的variablez字段被设置为omit相关值时，Ansible会将该字段从循环项中移除，导致循环项仅包含text字段。
   • 在部分Ansible版本中，这种循环项结构的不一致（部分有variablez字段，部分没有）会导致Ansible无法正确遍历循环并逐个判断when条件，最终误判所有循环项都不满足条件，从而跳过整个任务。

要解决这个问题，应避免在循环项中使用omit，改用正常的变量定义和条件判断实现跳过逻辑，例如将test3_var定义为None，再通过when条件跳过对应循环项。

内容的提问来源于stack exchange，提问作者stev-e