Ansible AWX Playbook触发Github仓库Python脚本异常问题

• script模块默认适配Linux/Unix类POSIX环境，传输到Windows主机的Python脚本不会自动绑定Python解释器执行。Windows会根据.py后缀的文件关联调用对应程序，多数服务器上.py默认关联的是文本编辑器而非解释器，因此会出现文件传输成功、返回码rc=0、无报错但脚本实际未启动进程的现象，你看到的CLIXML格式输出是PowerShell初始化的正常日志，不是执行报错。
• 原生command模块是为POSIX环境开发的，在Windows目标主机上执行时不会自动适配Windows的路径规则、可执行文件查找逻辑，加上你没有指定脚本的绝对路径，触发了Ansible默认的Linux环境Python解释器探测逻辑，才会抛出遍历Linux路径找不到解释器的错误。

方案1：修正script模块参数（推荐，适配AWX项目同目录托管脚本场景） #

不需要调整仓库文件结构，直接给script模块显式指定Windows下的Python解释器路径即可，脚本会自动传输到目标主机临时目录执行，执行完成后自动清理：

- name: Checking for duplicate clients
  script:
    path: duplicate_clients.py
    # 写py.exe绝对路径避免PATH识别问题，py启动器默认安装在C:\Windows目录
    executable: C:\Windows\py.exe
  # 给py启动器传-3参数指定调用Python3版本
  args:
    - -3
  register: check_result

# 调试时打开下面配置可以直接看到脚本的stdout/stderr输出
# - name: Print script execution result
#   debug:
#     var: check_result

如果目标主机没有安装py启动器，把executable的值换成你实际安装的python.exe绝对路径即可，比如C:\Python311\python.exe。

方案2：win_copy+win_command组合（适合需要在目标主机留存脚本的场景） #

使用Windows专用模块先把脚本复制到目标主机固定目录，再显式调用解释器执行，稳定性更高：

- name: Create script storage directory on target host
  win_file:
    path: C:\AWX_Managed_Scripts
    state: directory

- name: Copy Python script from AWX project to target host
  win_copy:
    src: duplicate_clients.py
    dest: C:\AWX_Managed_Scripts\duplicate_clients.py
    # 每次执行覆盖旧版本脚本
    force: yes

- name: Run duplicate client check
  win_command: C:\Windows\py.exe -3 C:\AWX_Managed_Scripts\duplicate_clients.py
  register: check_result

• 所有针对Windows目标主机的操作，优先使用win_前缀的专用模块（win_command/win_shell/win_copy等），非win前缀的原生模块默认适配POSIX环境，在Windows上极易出现路径、权限、执行逻辑不匹配问题。
• 正式跑脚本前先执行一次ad-hoc命令验证目标主机Python环境可用：在AWX上对应主机组跑临时命令，模块选win_command，参数填C:\Windows\py.exe -3 --version，确认能正常返回Python3版本号再执行业务脚本。
• 确认AWX配置的Windows远程连接账号有脚本需要的操作权限（文件读写、服务操作等），低权限账号会出现脚本执行无报错但业务逻辑不生效的问题。
• 如果脚本执行时长超过Ansible默认连接超时时间，给任务添加async、poll参数设置异步执行，避免连接中断导致脚本被强制终止。

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