Ansible include_vars模块加载变量文件偶发挂起问题排查求助

排查步骤 #

• 运行剧本时添加-vvvv参数开启debug级日志，定位挂起阶段：确认是文件读取环节卡住、变量解析环节卡住，还是存在文件锁/权限冲突问题
• 校验路径解析一致性：不同剧本执行时的工作目录不同，相对路径解析结果会出现偏差，即使人工判断路径合法，也可能出现偶发路径指向错误、误读其他同名文件的情况。可打印{{ myDynamicVars }}的实际解析结果和{{ ansible_env.PWD }}当前工作目录验证
• 检查目标变量文件属性：确认是否存在超大内容（单文件超过1M）、变量嵌套层级过深、特殊转义字符的情况，这类问题会导致YAML解析逻辑出现偶发超时
• 检查文件存储介质：如果变量文件存放在NFS、SMB等网络挂载盘，或者磁盘IO负载过高、存在坏道，会出现文件读取间歇性阻塞
• 校验变量冲突：检查静态加载的../data/my-static-vars.yaml中是否存在和动态加载文件重名的变量，变量覆盖逻辑冲突会引发偶发解析死锁

解决方法 #

• 替换相对路径为基于playbook_dir内置变量的绝对路径，消除不同执行上下文的路径解析差异，示例如下：

- name: Load vars file {{ myDynamicVars }} 
  include_vars: 
    file: "{{ playbook_dir }}/../../../input/data/my-dynamic-vars.yaml"

• 给include_vars任务添加超时限制，Ansible 2.10+版本支持async参数控制任务超时，避免无限挂起，示例如下：

- name: Load vars file {{ myDynamicVars }}
  include_vars:
    file: "{{ myDynamicVars }}"
  async: 30
  poll: 2

• 若变量文件过大，拆分变量为多个小文件分批加载，降低单次解析负载
• 若存在变量名冲突，在include_vars参数中添加name参数指定命名空间，避免变量覆盖，示例如下：

- name: Load vars file {{ myDynamicVars }}
  include_vars:
    file: "{{ myDynamicVars }}"
    name: dynamic_vars

加载后的变量可通过dynamic_vars.xxx的形式调用，不会和已有变量冲突

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