Jenkins无法找到Python的原因及解决方法

核心原因 #

Jenkins以LocalSystem账户运行时，使用的是系统级环境变量，而非你当前登录用户的用户级环境变量。你手动在CMD中能运行Python，是因为当前用户的PATH包含了Python路径，但LocalSystem的PATH可能并未配置。

解决方案 #

1. 检查并配置系统级PATH变量 #

• 打开「系统属性」→「高级」→「环境变量」
• 在「系统变量」区域找到Path，确认是否包含Python的安装目录（比如C:\Python39）和Scripts目录（C:\Python39\Scripts）
• 如果没有，添加对应的路径，点击「确定」保存
• 重启Jenkins服务，让新的环境变量生效

2. 直接使用Python绝对路径调用 #

如果暂时不想修改环境变量，可以在Jenkinsfile中直接指定Python可执行文件的绝对路径：

bat '"C:\\Program Files\\Python39\\python.exe" --version'

注意：路径包含空格时，需要用双引号包裹，并且在Groovy中要转义反斜杠。

3. 通过Jenkins全局工具配置调用（推荐） #

如果安装了Python相关插件（如ShiningPanda或官方Python插件）：

• 进入Jenkins后台→「全局工具配置」
• 找到Python配置项，点击「添加Python」，填写名称（如Python39），并指定Python安装目录的路径
• 在Jenkinsfile中通过tool指令引用：

pipeline {
    agent any
    tools {
        python 'Python39' // 对应全局工具配置的名称
    }
    stages {
        stage('验证Python') {
            steps {
                bat 'python --version'
            }
        }
    }
}

4. 验证LocalSystem的PATH配置 #

创建一个check_path.bat文件，内容如下：

echo %PATH%

在Jenkinsfile中执行这个脚本：

bat 'check_path.bat'

查看输出的PATH内容，确认是否包含Python路径，以此排查环境变量是否生效。

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