Ansible使用include_role时变量覆盖引发OS特定文件加载异常？

结论 #

这是Ansible的正常行为，并非bug，核心原因是任务上下文的变量继承特性导致的同名变量冲突。

问题根源 #

当在role_a的tasks/Ubuntu.yml中通过include_role引入role_b时，role_b会继承当前任务上下文的所有变量：

1. role_a执行include os specific tasks步骤时，定义了名为params的变量，其paths指向tasks目录
2. 调用include_role: role_b后，role_b的任务会直接复用这个已存在的params变量
3. 当role_b执行gather os specific variables任务时，本该使用自己定义的、指向vars目录的params，但Ansible优先使用了继承来的params，导致错误地去tasks目录加载变量文件——而tasks/Ubuntu.yml是任务文件（不是字典格式的变量文件），因此抛出加载失败的错误。

而使用meta依赖（role_a/meta/main.yml配置dependencies）时，角色依赖会在独立的上下文执行，不会继承role_a任务中的变量；给params变量添加独特前缀（如params_role_a_vars）则避免了同名冲突，因此两种场景都能正常运行。

解决方案 #

有两种可靠的修复方式：

• 方式一：区分不同用途的params变量名
  给加载变量和加载任务的参数变量分别命名，避免同名冲突：

  # role_x/tasks/main.yml
  - name: gather os specific variables
    ansible.builtin.include_vars: "{{ lookup('ansible.builtin.first_found', params_vars) }}"
    vars:
      params_vars:
        files:
          - "{{ ansible_distribution }}-{{ ansible_distribution_major_version }}.yml"
          - "{{ ansible_distribution }}.yml"
        paths:
          - 'vars'
  
  - name: include os specific tasks
    ansible.builtin.include_tasks: "{{ lookup('ansible.builtin.first_found', params_tasks) }}"
    vars:
      params_tasks:
        files:      
          - "{{ ansible_distribution }}-{{ ansible_distribution_major_version }}.yml"
          - "{{ ansible_distribution }}.yml"
        paths:
          - 'tasks'
  

• 方式二：使用角色依赖替代include_role嵌套
  在role_a/meta/main.yml中配置依赖，让role_b在独立上下文执行：

  dependencies:
    - role: role_b
  

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