通过Ansible运行Python脚本时遇ModuleNotFoundError问题求助

问题分析 #

命令行可正常运行的Python脚本，通过Ansible script模块执行时触发ModuleNotFoundError，即使已在脚本中添加模块路径。核心原因多为Ansible执行环境与本地命令行环境存在差异，或脚本路径配置有误。

排查与解决步骤 #

1. 修正模块路径配置 #

先确认my_module的实际结构，对应调整脚本路径：

• 如果my_module是包含__init__.py的Python包（路径为/home/user/my_module）：
  脚本需添加包的父目录到sys.path，而非包目录本身：

  #!/usr/bin/python3
  import sys
  sys.path.append('/home/user')  # 改为包的父目录
  from my_module import property
  

• 如果my_module.py是单个文件，直接放在/home/user/my_module目录下：
  需调整导入方式，或确保路径指向模块所在目录：

  #!/usr/bin/python3
  import sys
  sys.path.append('/home/user/my_module')
  import my_module
  # 使用my_module.property调用目标对象
  

2. 统一Python解释器 #

Ansible可能使用与命令行不同的Python解释器，导致环境不一致：

• 将脚本的shebang行改为命令行使用的Python绝对路径（执行which python3可获取）：

  #!/usr/bin/python3
  

• 或在Playbook中指定解释器：

  -
    name: Play of file
    hosts: localhost
    strategy : free
    gather_facts: no
    vars:
      ansible_python_interpreter: /usr/bin/python3  # 与命令行一致的解释器路径
    tasks:
      -
        name: Executing python script.
        script: /home/user/my_script.py
        register: script_out
      -
        debug:
          var: script_out.stdout_lines  # 原Playbook此处拼写错误，需修正为stdout_lines
  

3. 检查权限与临时目录执行逻辑 #

Ansible script模块会将脚本复制到临时目录执行，需确保：

• 执行Ansible的用户对/home/user/my_module目录及文件有读取权限
• 模块依赖的所有文件均使用绝对路径，避免临时目录下找不到依赖

4. 通过环境变量设置PYTHONPATH #

可在Playbook中直接设置PYTHONPATH，替代脚本中的sys.path.append：

-
  name: Executing python script.
  script: /home/user/my_script.py
  environment:
    PYTHONPATH: "/home/user:{{ ansible_env.PYTHONPATH }}"
  register: script_out

此方式可确保Python能直接识别模块目录，无需修改脚本。

验证方法 #

修改后先在命令行测试脚本，确认正常运行后再执行Playbook。若仍有问题，可添加任务对比环境差异：

-
  name: Check Python environment
  command: python3 -c "import sys; print(sys.path)"
  register: python_path
-
  debug:
    var: python_path.stdout_lines

对比命令行与Ansible输出的sys.path，可快速定位路径问题。

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