在Ansible Shell命令中渲染本地环境变量失败的问题排查

核心问题是Jinja2模板渲染未正常完成，导致原始的模板表达式被直接传递给shell执行，而shell无法识别{{ ... }}语法，进而触发报错。具体诱因通常有以下几点：

• 变量定义位置或语法错误：如果variable没有正确定义在playbook的vars区块，或者定义时缺少引号（比如写成variable: lookup('env', 'VARIABLE')而非variable: "{{ lookup('env', 'VARIABLE') }}"），会导致lookup表达式没有被执行，而是被当作普通字符串存储，最终shell收到的就是未解析的原始内容。
• 冗余的vars.前缀：引用变量时不需要加vars.前缀，直接写{{ variable }}即可。多余的vars.会干扰Ansible的变量解析逻辑，导致无法正确定位到定义的变量，进而跳过模板渲染。
• playbook语法错误：如果playbook存在其他语法问题（比如缩进错误、区块闭合不全），Ansible可能会进入部分解析模式，无法完成完整的模板渲染，最终将未解析的表达式传递给shell。

正确的示例Playbook #

- name: 测试本地环境变量传递
  hosts: localhost
  vars:
    variable: "{{ lookup('env', 'VARIABLE') }}"
  tasks:
    - name: 输出变量值
      shell: echo "{{ variable }}"

执行命令VARIABLE=random ansible-playbook playbook.yml即可得到预期的random输出。

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