本文介绍如何在 Ansible 中准确统计带 when 条件的循环（如 loop）真正执行的次数，排除被跳过的迭代，通过注册结果、JMESPath 查询与算术运算实现精确计数。
本文介绍如何在 ansible 中准确统计带 `when` 条件的循环（如 `loop`）真正执行的次数，排除被跳过的迭代，通过注册结果、jmespath 查询与算术运算实现精确计数。
在 Ansible 中，当使用 when 条件控制循环项是否执行时（例如 when: not item.skip），register 捕获的 results 列表仍会包含所有原始项，但被跳过的项会在其对象中显式标记 "skipped": true。因此，不能直接用 results | length 作为“实际运行次数”——它返回的是总迭代数，而非满足条件并执行的次数。
正确做法是：
- 注册整个循环结果（推荐使用现代 loop 而非已弃用的 with_list）；
- 筛选出被跳过的项数量，利用 json_query 提取所有 skipped: true 的元素；
- 用总长度减去跳过数，即得真实执行次数。
以下是一个完整、可运行的示例：
- hosts: localhost
gather_facts: false
tasks:
- name: 执行条件循环并注册结果
debug:
msg: "working on {{ item.name }}"
loop:
- {name: t1, skip: True}
- {name: t2, skip: False}
- {name: t3, skip: False}
- {name: t4, skip: False}
- {name: t5, skip: True}
register: loop_results
when: not item.skip
- name: 统计跳过次数（使用 json_query）
set_fact:
skipped_count: "{{ loop_results.results | json_query('[?skipped]') | length }}"
- name: 计算实际运行次数
set_fact:
actual_run_count: "{{ loop_results.results | length - skipped_count | int }}"
- name: 输出统计结果
debug:
msg: |
总迭代数: {{ loop_results.results | length }}
跳过次数: {{ skipped_count }}
实际执行次数: {{ actual_run_count }}
运行后将输出：
ok: [localhost] => {
"msg": "总迭代数: 5\n跳过次数: 2\n实际执行次数: 3"
}
✅ 关键说明：
- loop_results.results 始终包含 5 个元素（对应原始列表长度），无论 when 是否跳过；
- json_query('[?skipped]') 是 JMESPath 表达式，精准匹配所有含 "skipped": true 的字典；
- set_fact 用于清晰分离计算逻辑，避免在 debug 中嵌套复杂表达式，提升可读性与复用性；
- 若需在后续任务中直接引用，actual_run_count 可作为变量安全使用（如条件判断、日志记录或 API 调用参数）。
⚠️ 注意事项：
- 确保已安装 jmespath Python 包（Ansible ≥ 2.10 默认依赖，旧版本需手动安装：pip install jmespath）；
- json_query 过滤对大小写敏感，字段名必须严格匹配（如 skipped 而非 Skipped）；
- 不要误用 results | selectattr('skipped') | list | length —— 在部分 Ansible 版本中可能因 skipped 字段缺失导致错误，json_query 更健壮。
掌握这一模式，即可在 CI/CD 流水线、批量资源部署或合规性检查等场景中，精准追踪条件化操作的执行规模。
