Ansible引用defaults/main.yml已定义变量却报未定义错误如何解决

你当前的目录组织、任务加载逻辑，完全没有触发Ansible角色的自动变量加载机制——本质是把一个外形符合角色目录结构的文件夹，当成普通任务脚本目录直接使用，全程没有走Ansible的正式角色加载流程。

具体问题拆解 #

• Ansible仅在目录被作为正式Role显式引入当前Play执行上下文时，才会自动扫描加载该角色下defaults/main.yml中的变量；绝对不会因为Playbook和任务文件存放在一个带defaults、tasks子目录的路径下，就自动关联读取该目录下的配置。
• 你当前的Playbook通过include: tasks/main.yml的方式拉取任务块，这个操作只会把tasks/main.yml内的任务逻辑加载到执行上下文，全程没有声明要使用对应的Redis角色，角色路径下的defaults/main.yml、defaults/task.yml根本不会被Ansible扫描识别，所有文件内定义的变量自然处于未定义状态。
• 额外的配置偏差：Ansible角色的默认变量固定要求写入defaults/main.yml，你创建的defaults/task.yml本身命名就不符合规范，就算后续角色被正常加载，这个文件里的变量也不会被自动读取。

可落地的解决步骤 #

1. 修正角色目录合规性
   按照Ansible标准角色规范整理文件：
   • 将defaults/task.yml中所有的变量内容，全部合并移动到defaults/main.yml中，删除命名错误的defaults/task.yml文件，保证defaults/main.yml完整包含所有Redis相关变量（包括redis_version、redis_download_url，以及redis_user、redis_port等配置项）。
2. 修正Playbook加载逻辑
   取消直接include任务文件的写法，改用Ansible原生的角色加载方式。本地测试阶段，可将当前Redis相关的角色根目录，移动到Playbook同级路径下的roles/redis/目录中，调整后的Playbook内容示例：

   ---
   - hosts: all
     become: true
     roles:
       - role: redis
   

   该写法下，Ansible会自动按照标准角色加载流程，依次读取roles/redis目录下defaults、tasks等规范路径的文件，所有变量会被正常注入执行上下文，之前的未定义报错会直接消失。
3. 加载有效性校验
   调整完成后，先执行语法与变量校验命令，提前排查加载问题：

   ansible-playbook playbook.yml --syntax-check
   

   排查阶段可临时在任务最开头添加调试任务，打印redis_download_url等变量值，确认加载正常后再执行完整流程。

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