Ansible解析ansible_facts报错：NoneType不可迭代的排查与解决

问题场景 #

作为Ansible新手，我在编写Playbook管理Docker Swarm节点的NFS挂载，需要实现以下功能：

• 检查节点上已挂载的NFS共享
• 挂载列表中不存在的指定NFS共享
• 卸载节点上不应存在的NFS共享

在使用--check参数运行Playbook时，触发了模板类型错误：'NoneType' object is not iterable，错误指向表达式{{ ansible_facts | community.general.json_query(query) | list }}。虽然已确认ansible_facts中存在fstype="nfs4"的挂载项，但修改JSON查询语句后仍无法解决报错。

解决方案 #

通过调整JSON查询路径，添加to_json | from_json处理，并修改查询条件为匹配所有包含nfs的文件系统类型，成功解决了该问题。

原查询任务

- name: gather mounted nfs shares as ansible_fact
  ansible.builtin.set_fact:
    nfs_mounts_list: "{{ ansible_facts | json_query(query) | list }}"
  vars:
    query: "ansible_facts.ansible_mounts[?fstype=='nfs4'].mount"

修改后的查询任务

- name: gather mounted nfs shares from ansible_facts
  ansible.builtin.set_fact:
    nfs_mounts_list: "{{ ansible_facts | to_json | from_json | community.general.json_query(query) | list }}"
  vars:
    query: mounts[?contains(fstype, `nfs`)].mount

关键调整说明 #

1. 添加to_json | from_json转换：在ansible_facts传递给json_query前，先序列化为JSON再反序列化，确保数据结构在--check模式下保持可迭代的正确格式，避免出现NoneType对象。
2. 简化查询路径：将原查询中的ansible_facts.ansible_mounts简化为mounts，经过转换后的ansible_facts结构更直接，无需多层嵌套调用。
3. 放宽文件系统类型匹配：使用contains(fstype, nfs)替代原有的精确匹配fstype=='nfs4'，可以兼容nfs、nfs4等多种NFS文件系统类型，提升Playbook的通用性。

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