为何Ansible角色geerlingguy.postgresql无法找到变量？

我编写了如下Ansible Playbook：

- hosts: vdtreportlive
  vars_files:
    - ./vars/postgresql.yml
    - ./vars/postgresql_report.yml
  roles:
    - role: geerlingguy.postgresql

运行时出现错误：

ERROR! couldn't resolve module/action 'postgresql_user'. This often indicates a misspelling, missing collection, or incorrect module path.

但修改为如下Playbook检查变量时，却能得到预期结果：

- hosts: vdtreportlive
  vars_files:
    - ./vars/postgresql.yml
    - ./vars/postgresql_report.yml
  tasks:
    - name: Print the value of variable postgresql_user
      debug:
        msg: "{{ postgresql_user }} "

执行结果为：

ok: [vdtreportlive] => {
    "msg": "postgres "
}

为何该角色无法找到变量，而任务却可以？

你误解了错误的核心原因——这个报错和变量找不到完全无关。错误提示明确说明是无法解析postgresql_user模块/动作，并非变量postgresql_user不存在。

debug任务能正常输出变量值，证明你的变量加载逻辑完全正常。角色执行报错，是因为geerlingguy.postgresql角色依赖的PostgreSQL相关模块（比如postgresql_user）属于Ansible官方的community.postgresql集合，而你的环境没有安装该集合，或是模块路径配置存在问题。

解决方法：

• 安装community.postgresql集合：

  ansible-galaxy collection install community.postgresql
  

• 若你的Ansible版本低于2.10，需要在Playbook中明确指定集合名称，例如将模块调用写为community.postgresql.postgresql_user（新版本默认支持集合，无需额外指定）。

额外说明：角色内部的变量逻辑和你debug的变量是独立的，但你的错误根本没到变量加载阶段，是模块缺失导致执行直接中断。

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