Ansible用include_vars加载变量目录跨引用报错的原因及最佳实践

报错核心原因 #

之前的写法存在两个对include_vars模块的理解偏差：

• 给include_vars加上name: test参数后，所有从目标目录读取的变量都会被打包存入test字典，不会被提升为全局可直接引用的变量。你在common.yml里定义的app_drive实际存储路径是test.app_drive，并非全局变量app_drive，因此在oracle_client.yml里直接写{{ app_drive }}时，Ansible会在全局变量空间找不到对应值，触发未定义报错。
• 官方文档提到的「按字母序排序加载文件、支持跨文件引用」的特性，仅在变量直接加载为全局变量的场景下生效。一旦你指定了name参数，所有文件的内容都会被作为字典的字面量独立解析，解析时只会在当前文件的上下文里查找变量，不会跨其他同目录文件匹配引用关系，和你预期的加载逻辑完全不同。

适配需求的最佳实现方式 #

针对「同目录按业务逻辑拆分变量文件、支持跨文件互相引用」的目标，有两种可直接落地的成熟方案：

方案1：直接加载为全局变量（最推荐，适配你现有目录结构） #

直接去掉原任务里的name: test参数，让加载的变量直接进入全局变量空间：

- name: 加载all目录下所有拆分的业务变量
  include_vars:
    dir: all
    extensions: ["yml", "yaml"]

这种写法的特性完全匹配你的预期：

• 自动按文件名字母序排序加载目录下的所有yaml文件，你当前的文件加载顺序为ansible.yml → common.yml → oracle_client.yml
• 所有文件内定义的变量会直接合并到全局变量中，不需要通过字典路径访问
• 因为common.yml排在oracle_client.yml之前，当加载完common.yml时，app_drive已经是全局可用变量，后续解析oracle_client.yml中oracle_base的引用时，就能正常匹配到变量值，不会触发未定义错误。

注意：如果后续有跨文件交叉引用的复杂场景，可以给变量文件加数字前缀固定加载顺序，比如00_common.yml、10_oracle_client.yml，从根本上避免字母序排序错乱导致的引用失败。

方案2：保留字典结构的加载方式（适合需要统一层级管理的场景） #

如果你确实需要把所有变量打包到一个统一字典下做管理，不要在变量文件内部写跨文件引用，改成两阶段处理：

1. 第一阶段：完整加载所有原始变量到目标字典，此阶段不做任何跨文件解析

   - name: 加载所有拆分变量到test字典
     include_vars:
       dir: all
       name: test
   

2. 第二阶段：等所有变量加载完成后，统一对存在依赖关系的变量做赋值补全

   - name: 补全存在跨引用关系的字段
     set_fact:
       test: "{{ test | combine({'oracle_base': test.app_drive ~ '\\app\\oracle'}) }}"
   

这种写法不受文件加载顺序的影响，适合变量依赖关系复杂、需要清晰层级管理的项目场景。

补充说明：之前你依赖的官方文档「加载前按字母序排序」的特性，本质是为了保证全局变量加载时的可预测性，确保被依赖的变量先于引用它的变量完成加载，而不是支持在打包字典的场景下做跨文件引用。

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