在Azure DevOps经典UI中运行Python脚本遇问题求助

常见排查与修复步骤 #

• 检查环境变量配置
  自托管代理的运行用户上下文可能和你手动安装Python的用户不一致。打开代理机器的系统环境变量，确认Path中已添加Python安装目录（如C:\PythonXX）和Scripts子目录（C:\PythonXX\Scripts）。修改后重启自托管代理服务，让新的环境变量生效。

• 验证代理用户权限
  自托管代理通常以特定账户运行（比如本地系统账户或指定服务账户），该账户可能没有Python安装目录的读取权限。右键Python安装文件夹，进入「属性」-「安全」面板，给代理运行账户添加读取和执行权限。

• 手动指定Python绝对路径
  若环境变量未生效，可在Pipeline任务中直接用绝对路径调用Python：

  - script: 'C:\Python311\python.exe your_script.py'
    displayName: '通过绝对路径运行Python脚本'
  

  也可在脚本中先声明路径再执行操作：

  - script: |
      set PYTHON_PATH=C:\Python311\python.exe
      %PYTHON_PATH% -m pip install -r requirements.txt
      %PYTHON_PATH% your_script.py
    displayName: '指定Python路径执行任务'
  

• 修复UsePython任务失效问题
  如果UsePythonVersion任务无法正常工作，先确保Python已注册到代理的工具缓存中。手动运行代理目录下的externals\python\python.exe -m pip install azure-pipelines-tool-lib，再执行注册命令：

  & "C:\Python311\python.exe" -m azure-pipelines-tool-lib register "Python" "3.11.x" "C:\Python311"
  

  注册完成后重启代理，再尝试使用UsePythonVersion任务。

• 重启代理服务
  代理进程可能缓存了旧的环境变量配置，打开系统「服务」面板，找到Azure Pipelines Agent服务，右键选择重启，确保新配置被加载。

• 重新安装自托管代理
  若以上方法均无效，备份代理配置文件后卸载当前代理，重新下载并安装。安装过程中确保使用的账户拥有Python安装目录的访问权限。

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