Ansible自定义Python模块：如何导入控制器端安装的Python模块

核心原因 #

Ansible运行自定义模块时，会把模块文件传输到远程节点的临时目录执行，此时Python的搜索路径（sys.path）可能没包含系统级的dist-packages目录——哪怕你在命令行直接导入模块完全正常，Ansible的执行环境路径逻辑和原生命令行不一样。

直接解决方案：设置PYTHONPATH环境变量 #

在playbook里为任务指定PYTHONPATH，把系统包所在目录加入Python的搜索路径：

- name: 执行自定义模块
  my_custom_module:
    # 填写你的模块参数
  environment:
    PYTHONPATH: "/usr/local/lib/python3.8/dist-packages:{{ ansible_env.PYTHONPATH | default('') }}"

备选方案 #

如果上面的方法不生效，还可以试试这两种：

• 在模块代码里手动添加路径：在自定义模块的开头加入以下代码，强制把系统包目录加入Python搜索路径：

  import sys
  sys.path.append("/usr/local/lib/python3.8/dist-packages")
  import monotonic
  

• 确认Python解释器路径：确保Ansible使用的是你预期的Python解释器，在playbook里明确指定：

  - hosts: your_target_hosts
    vars:
      ansible_python_interpreter: /usr/bin/python3
    tasks:
      - name: 执行自定义模块
        my_custom_module:
          # 填写你的模块参数
  

补充说明 #

你提到更新Ansible后功能失效，大概率是新版本调整了模块执行时的Python路径优先级，强制指定PYTHONPATH能直接覆盖这个问题，让Python优先搜索系统全局安装的包目录。

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