如何在Ansible角色argument_spec中支持任意深度的递归树形参数？

Ansible原生的argument_spec机制不支持递归结构验证，这是当前的功能限制。针对你需要验证family_tree这类任意深度树形参数的需求，这里提供两种更贴合你的偏好的方案：

方案一：基于argument_spec的宽松验证+文档约束 #

既然无法通过原生语法实现递归验证，我们可以先做基础结构校验，再通过角色文档明确递归结构规则。

在meta/arguments_spec.yml中配置：

argument_specs:
  main:
    options:
      family_tree:
        description: 任意深度的家族树结构，每个节点需包含`name`字段，可选`children`字段为同结构的列表
        type: dict
        required: true
        options:
          name:
            description: 家族成员姓名
            type: str
            required: true
          children:
            description: 子成员列表，每个元素结构与`family_tree`一致
            type: list
            elements: dict

优缺点 #

• 优点：完全遵循argument_spec的设计初衷，无需额外任务，配置简洁
• 缺点：无法严格校验children列表中每个节点的结构，依赖用户遵循文档规范；若要补全校验，可在角色任务中添加轻量检查

方案二：用assert模块实现递归验证（比JSON Schema更直观） #

如果你能接受在任务开头添加少量验证逻辑，assert模块结合递归查询可以实现可靠的结构校验，且比JSON Schema更易读维护。

在角色的tasks/main.yml开头添加：

- name: 递归验证家族树结构合法性
  assert:
    that:
      - node.name is defined and node.name is string
      - (node.children is not defined) or (node.children is list)
    fail_msg: "无效的家族树节点：{{ node }}，必须包含字符串类型的`name`字段，`children`可选且为列表"
  loop: "{{ query('ansible.builtin.subelements', [family_tree], 'children', skip_missing=True) | map('first') | list + [family_tree] }}"
  loop_control:
    loop_var: node

逻辑说明 #

• 用subelements查询递归遍历family_tree的所有子节点，再加上根节点，得到所有需要验证的节点列表
• 对每个节点检查：必须有name且为字符串；children要么不存在，要么是列表（列表内的节点会被循环自动覆盖验证）
• 相比JSON Schema，这种方式无需额外编写Schema文件，逻辑更直观，符合Ansible用户的常规任务编写习惯

总结 #

• 若严格要求只用argument_spec文件，方案一的基础校验+文档约束是唯一选择
• 若可以接受少量前置验证任务，方案二的assert递归验证兼顾了可靠性和可读性，比JSON Schema更适合你的需求

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