Ansible中group_vars嵌套变量无法合并的问题咨询

我之前踩过一模一样的坑！Ansible 默认对嵌套的字典/哈希变量采用替换而非合并的处理逻辑，这就是你遇到的问题：当子组（比如frontend）定义了和父组（common）同名的嵌套变量时，子组的变量会完全覆盖父组的对应变量，而不是把两者的键值对合并到一起。

问题场景还原 #

先对应你的配置结构确认下：

• hosts.ini里[common:children]包含frontend和backend，server1在frontend组，server2在backend组
• group_vars/common.yaml、frontend.yaml、backend.yaml都定义了嵌套变量（比如假设是app_config这类字典）

举个具体例子：
group_vars/common.yaml：

app_config:
  log_level: info
  timeout: 30

group_vars/frontend.yaml：

app_config:
  port: 8080

默认情况下，执行ansible server1 -m debug -a "var=app_config"会得到：

app_config:
  port: 8080

父组里的log_level和timeout被完全覆盖了，这就是你看到的“嵌套变量未合并”现象。

两种解决方案 #

方案一：全局启用哈希合并（谨慎使用） #

可以在ansible.cfg中配置全局的哈希行为为合并：

[defaults]
hash_behaviour = merge

配置后，Ansible会自动合并所有嵌套的字典变量，子组的变量会补充到父组的变量中，而不是替换。上面的例子里，server1的app_config会变成：

app_config:
  log_level: info
  timeout: 30
  port: 8080

⚠️ 注意：这个配置是全局生效的，可能会影响其他playbook的变量逻辑（比如有些场景你确实需要替换而不是合并），如果是团队协作项目，一定要和其他成员沟通确认后再使用。

方案二：局部使用combine过滤器（推荐） #

如果不想修改全局配置，可以通过combine过滤器手动合并变量，这种方式更灵活，也不会影响其他场景。

比如在debug命令里直接查看合并后的变量：

ansible server1 -m debug -a "var=hostvars['common']['app_config'] | combine(hostvars['server1']['app_config'], recursive=True)"

如果需要在playbook中使用合并后的变量，可以用set_fact定义：

- name: 合并嵌套配置变量
  hosts: frontend
  tasks:
    - set_fact:
        merged_app_config: "{{ hostvars['common']['app_config'] | combine(app_config, recursive=True) }}"
    - debug:
        var: merged_app_config

这里的recursive=True参数是为了处理更深层次的嵌套（比如app_config里还有子字典），如果只有一层嵌套可以省略，但加上更稳妥。

额外提示 #

如果你的嵌套变量层级比较深，或者需要更精细的合并控制，可以研究下combine过滤器的其他参数（比如list_merge），来控制列表类型变量的合并逻辑。

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