Jenkins构建中Command Not Found错误排查求助

问题根源分析 #

1. Docker化Jenkins环境中python3: not found #

你的Jenkins Docker镜像默认未预装Python3，导致系统无法识别python3命令。

2. Mac本地环境中coverage: command not found #

Jenkins的每个sh步骤都是独立的Shell进程，你在Build阶段执行的. venv/bin/activate仅对当前sh进程生效，Test阶段的sh进程并未激活虚拟环境，而coverage是安装在虚拟环境内的，因此系统找不到该命令。

针对性解决方案 #

方案1：修复Docker环境的Python依赖 #

如果使用官方Jenkins镜像，可在Pipeline中先安装Python3：

pipeline {
    agent any

    stages {
        stage("Prepare Python") {
            steps {
                // 针对Debian/Ubuntu系镜像安装Python3依赖
                sh "apt-get update && apt-get install -y python3 python3-venv python3-pip --no-install-recommends"
            }
        }
        // 后续Checkout、Build、Test阶段按下方方案修改
    }
}

也可以直接使用预装Python的自定义Jenkins镜像，避免每次构建重复安装。

方案2：修复虚拟环境的激活问题（核心） #

有两种可靠方式确保虚拟环境内的命令能被正确调用：

方式A：合并Shell命令到同一进程

将需要在虚拟环境中执行的命令放在同一个sh块里，确保虚拟环境激活状态持续生效：

pipeline {
    agent any

    stages {
        stage("Checkout") {
            steps {
                checkout([$class: 'GitSCM', branches: [[name: '*/main']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[url: '<My Github Repo Url>']]])
            }
        }

        stage("Build") {
            steps {
                sh '''
                    python3 -m venv venv
                    . venv/bin/activate
                    pip3 install -r requirements.txt
                '''
            }
        }

        stage("Test") {
            steps {
                sh '''
                    . venv/bin/activate
                    coverage run -m pytest
                '''
            }
        }
    }
}

方式B：直接调用虚拟环境内的命令绝对路径

无需激活虚拟环境，直接指定虚拟环境目录下的可执行文件路径：

pipeline {
    agent any

    stages {
        stage("Checkout") {
            steps {
                checkout([$class: 'GitSCM', branches: [[name: '*/main']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[url: '<My Github Repo Url>']]])
            }
        }

        stage("Build") {
            steps {
                sh "python3 -m venv venv"
                sh "venv/bin/pip3 install -r requirements.txt"
            }
        }

        stage("Test") {
            steps {
                sh "venv/bin/coverage run -m pytest"
            }
        }
    }
}

验证步骤 #

1. 选择上述任一方案修改Jenkinsfile
2. 重新触发Jenkins构建
3. 查看控制台输出，确认python3、coverage命令正常执行，测试覆盖率报告生成成功

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