Ansible变量合并异常：非特殊组主机意外合并DNS变量

问题场景 #

在Ansible角色的defaults/main.yml与inventory的group_vars/special_group.yml中均定义了名为DNS的列表变量：

角色defaults/main.yml配置：

DNS:
  - "0.0.0.0" # 示例IP
  - "0.0.0.1"

inventorygroup_vars/special_group.yml配置：

DNS:
  - "0.0.0.2" # 示例IP
  - "0.0.0.3"

执行角色时，special_group组的主机仅使用special_group.yml中的DNS变量（符合预期），但非special_group组的主机却合并了两个文件中的DNS变量值，需求是让这些主机仅使用defaults/main.yml中的DNS配置。

当前修改DNS的任务代码：

- name: Change DNS
  nmcli:
    conn_name: "{{ connection_name }}"
    dns4: "{{ DNS }}"
    state: present

原因分析 #

非目标主机出现变量合并，主要是以下两种情况：

• 这些主机直接或间接属于special_group组（比如inventory中通过组嵌套继承了该组），导致group_vars/special_group.yml的变量被加载，触发Ansible默认的列表变量合并逻辑
• 全局配置（如group_vars/all.yml）中也定义了DNS变量，与角色defaults的变量产生合并

解决方案 #

方案1：排查并修正主机组归属 #

先验证目标主机的组归属，确认是否意外继承了special_group：

ansible <目标主机名或组名> -m debug -a "var=group_names"

如果输出中包含special_group，调整inventory的组结构，确保非目标主机不在该组或其嵌套组内即可解决问题。

方案2：拆分任务，按组指定变量 #

无需修改现有变量名，直接在任务中根据主机组选择对应的变量：

# 为special_group组主机配置专属DNS
- name: Change DNS for special_group hosts
  nmcli:
    conn_name: "{{ connection_name }}"
    dns4: "{{ DNS }}"
    state: present
  when: "'special_group' in group_names"

# 为其他主机使用角色默认DNS
- name: Change DNS for non-special_group hosts
  nmcli:
    conn_name: "{{ connection_name }}"
    dns4: "{{ lookup('file', role_path ~ '/defaults/main.yml') | from_yaml | json_query('DNS') }}"
    state: present
  when: "'special_group' not in group_names"

这里通过lookup直接读取角色defaults文件的原始DNS变量，避免被其他层级的变量干扰。

方案3：调整全局变量合并策略（谨慎使用） #

Ansible默认的hash_behaviour为merge，会合并列表类型变量。可在ansible.cfg中修改为replace，让高优先级变量直接替换低优先级变量：

[defaults]
hash_behaviour = replace

⚠️ 注意：该设置会全局影响所有变量的合并逻辑，可能导致其他依赖合并行为的任务异常，需充分测试后使用。

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