Ansible角色无法加载vars子文件夹变量，请求排查解决

嘿，别着急，我帮你拆解一下这个问题～

问题根源分析 #

1. 角色目录结构错误（最可能的核心原因） #

你提到“在/etc/ansible/roles下手动创建tasks和roles文件夹”，这不符合Ansible角色的标准目录规范。正确的角色结构应该是每个角色对应一个独立的子目录，比如你的user角色应该是这样的层级：

/etc/ansible/roles/
└── user/          # 角色名称专属目录
    ├── tasks/     # 任务文件存放目录
    │   └── main.yml
    └── vars/      # 角色变量存放目录
        └── main.yml

如果你的目录结构不是这样（比如把tasks和vars直接放在/etc/ansible/roles根目录下），Ansible根本找不到roles/user/vars/main.yml里定义的变量，自然会抛出groups_additional未定义的错误。

2. groups参数的表达式写法有瑕疵 #

就算变量能正常加载，你当前的写法也存在两个小问题：

• 当groups_additional未定义时，会留下多余的空格，可能导致user模块解析组名出错
• 条件判断的语法可以更简洁，用Jinja2的default()过滤器会更健壮

解决方案 #

第一步：修复角色目录结构 #

先把目录调整成Ansible认可的标准结构：

1. 进入/etc/ansible/roles目录
2. 创建正确的user角色目录层级：

mkdir -p /etc/ansible/roles/user/{tasks,vars}

3. 把你现有的任务文件和变量文件，分别移动到对应的tasks和vars子目录下。

第二步：优化groups参数的表达式 #

修改roles/user/tasks/main.yml里的user任务，把groups字段改成更稳妥的写法：

- name: Check '{{ user_name }}' user, set his pwd and groups
  ansible.builtin.user:
    name: '{{ user_name }}'
    password: '{{ user_pwd }}'
    group: '{{ group_name | default(user_name) }}'
    # 用更简洁的方式处理组名拼接，避免多余空格或未定义变量问题
    groups: '{{ group_name | default(user_name) }}{{ ", " + groups_additional | default("") }}'
  become: yes

额外验证小技巧 #

如果调整后还是有问题，可以在任务里加一个调试步骤，确认变量是否被正确加载：

- name: Debug to check if variable exists
  ansible.builtin.debug:
    var: groups_additional
  become: yes

运行剧本时加上-v参数，看看输出里是否能显示groups_additional的值，这样就能快速定位变量是否被成功加载了。

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