在virtualenv安装pymongo后Ansible提示ModuleNotFoundError的解决方法

核心原因 #

你将pymongo安装到了自定义虚拟环境/home/user/.venv中，但Ansible默认使用目标节点的系统Python解释器执行community.mongodb.mongodb_user模块，导致模块无法找到虚拟环境内的依赖包。

修正步骤 #

1. 确认pymongo已正确安装到虚拟环境 #

先验证虚拟环境内是否确实存在pymongo，执行以下命令（需先激活虚拟环境）：

source /home/user/.venv/bin/activate
pip list | grep pymongo

如果未找到pymongo，可调整pip安装任务，明确指定虚拟环境使用的Python版本（避免与系统Python混淆）：

- name: Install python packages
  ansible.builtin.pip:
    name:
      - pymongo
    virtualenv: /home/user/.venv
    virtualenv_python: python3  # 可指定具体版本如python3.10，匹配目标节点的Python版本

2. 让MongoDB用户任务使用虚拟环境的Python #

修改community.mongodb.mongodb_user任务，通过ansible_python_interpreter指定虚拟环境内的Python路径，确保模块调用虚拟环境中的依赖：

- name: Create database user
  community.mongodb.mongodb_user:
    login_user: root
    login_password: 12345
    database: somedb
    name: some_user
    password: 12345
    state: present
    roles:
       - { db: "xxx", role: "dbOwner" }
       - { db: "yyy", role: "dbOwner" }
  vars:
    ansible_python_interpreter: /home/user/.venv/bin/python

3. 可选：全局指定虚拟环境Python（针对整个Play） #

如果Play内多个任务都需要依赖虚拟环境，可在Play级别统一设置ansible_python_interpreter，无需逐个任务添加：

- name: MongoDB setup play
  hosts: your_target_host
  vars:
    ansible_python_interpreter: /home/user/.venv/bin/python
  tasks:
    - name: Install python packages
      ansible.builtin.pip:
        name:
          - pymongo
        virtualenv: /home/user/.venv
    - name: Create database user
      community.mongodb.mongodb_user:
        # 填写任务参数...

内容的提问来源于stack exchange，提问作者matteo-g