Ansible中vars_files引入变量文件失效的原因及解决办法

核心原因 #

1. 手动引用group_vars属于冗余操作，易引发路径/优先级冲突 #

Ansible会自动加载与inventory同级的group_vars和host_vars目录下的变量文件，无需在playbook中通过vars_files手动引入。你的ansible.cfg已指定inventory = ./hosts（项目根目录下的hosts文件），因此项目根目录的group_vars会被自动加载，手动添加vars_files不仅多余，还可能因路径解析或变量优先级逻辑混乱，导致变量未按预期加载。

2. 变量加载顺序与覆盖问题（默认行为） #

Ansible默认采用replace变量合并策略（而非merge）：如果group_vars/development.yml中定义了server字典但未包含hostname键，后续加载的all.yml中的server会完全替换前者；若development.yml未定义server，则all.yml的配置应正常生效。但手动指定vars_files会打乱自动加载的优先级，增加变量覆盖风险。

3. 潜在路径解析错误 #

虽然vars_files中的../group_vars/...相对于playbook目录是正确的，但如果执行ansible-playbook时的当前工作目录不是项目根目录，会导致相对路径解析错误，变量文件无法被加载。

解决步骤 #

1. 移除playbook中的vars_files配置 #

修改playbooks/development.yml，删除vars_files段，让Ansible自动加载group_vars：

- hosts: all
  name: Development Playbook
  become: true
  roles:
    - ../roles/common

2. 验证inventory分组与变量匹配 #

确保hosts文件中目标主机属于正确分组（比如development组对应group_vars/development.yml），默认所有主机都属于all组，因此group_vars/all.yml的配置会对所有主机生效。

3. 检查变量文件的语法与内容 #

• 确认group_vars/all.yml的YAML语法无错误（缩进、冒号等格式正确），当前内容是有效的：

  server:
    hostname: "myhostname"
    timezone: "Europe/Berlin"
  

• 如果group_vars/development.yml中定义了server变量，确保它包含hostname和timezone键；或者直接删除该变量定义，让all.yml的配置生效。

4. 验证变量加载情况 #

在playbook中添加前置debug任务，确认变量是否正确加载：

- hosts: all
  name: Development Playbook
  become: true
  pre_tasks:
    - name: Debug server variable
      ansible.builtin.debug:
        var: server
  roles:
    - ../roles/common

执行playbook后，查看输出的server变量结构，确认hostname和timezone键是否存在。

5. 确保执行playbook时的工作目录正确 #

切换到项目根目录（包含ansible.cfg、group_vars的目录），再运行命令：

ansible-playbook playbooks/development.yml

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