如何让Jenkins手动触发时仅在SCM变更时执行公共代码预构建

Jenkins完全支持你描述的场景——手动触发微服务构建任务时，仅当公共代码库存在变更时才执行预构建步骤，不需要依赖Git推送触发的轮询SCM机制。下面给你两种实用的实现方案，根据你的Jenkins任务类型选择即可：

方案一：用Jenkins Pipeline实现（推荐，灵活性更高） #

如果你的任务是Pipeline类型（现在Jenkins的主流用法），可以通过脚本逻辑直接对比公共代码库的提交记录，判断是否需要执行预构建。

核心思路是：每次手动触发任务时，拉取公共代码库的最新提交哈希，和上次构建时记录的哈希做对比——如果不一致，说明有变更，就执行公共库的构建部署；否则跳过。

示例Pipeline脚本：

pipeline {
    agent any
    environment {
        // 替换成你的公共代码库Git地址
        COMMON_REPO_URL = 'git@your-git-server.com/common-utils.git'
        // 存储上次公共库提交哈希的文件（可存在Jenkins服务器的固定路径，或项目目录）
        LAST_COMMIT_RECORD = '/var/jenkins_home/records/common-lib-last-commit.txt'
    }
    stages {
        stage('检查公共代码库变更') {
            steps {
                script {
                    // 拉取公共代码库最新代码
                    git url: COMMON_REPO_URL, branch: 'main'
                    // 获取当前最新提交的哈希值
                    def currentCommit = sh(script: 'git rev-parse HEAD', returnStdout: true).trim()
                    // 读取上次记录的提交哈希
                    def lastCommit = fileExists(LAST_COMMIT_RECORD) ? readFile(LAST_COMMIT_RECORD).trim() : ''

                    if (currentCommit != lastCommit) {
                        echo "检测到公共代码库有变更（上次提交：${lastCommit}，当前提交：${currentCommit}）"
                        // 执行公共库的构建和部署逻辑
                        sh './mvnw clean deploy -DskipTests'
                        // 更新记录的最新提交哈希
                        writeFile file: LAST_COMMIT_RECORD, text: currentCommit
                    } else {
                        echo "公共代码库无变更，跳过预构建步骤"
                    }
                }
            }
        }
        stage('构建并部署微服务') {
            steps {
                // 这里写你的微服务构建、部署逻辑
                echo "开始构建微服务..."
                sh './mvnw clean package'
                // 添加部署命令，比如kubectl apply或者其他部署脚本
            }
        }
    }
}

方案二：用Conditional BuildStep插件（适合自由风格任务） #

如果你的任务是传统的自由风格项目，可以通过插件实现条件判断：

1. 先在Jenkins插件管理中安装Conditional BuildStep插件；
2. 打开你的微服务构建任务，进入「预构建步骤」，添加「Conditional step (single)」；
3. 在条件设置中，选择「Run condition」→「SCM changes」，然后配置公共代码库的SCM信息（填写Git地址、分支等）；
4. 在这个条件步骤内部，添加公共代码库的构建部署操作——可以是直接执行构建命令，也可以调用专门的公共库构建任务；
5. 保存配置后，每次手动触发任务时，Jenkins会自动检查公共代码库的SCM是否有变更，只有当存在变更时才会执行预构建步骤。

额外注意事项 #

• 如果公共代码库和微服务在同一个Git仓库，可以直接用Jenkins内置的「变更集」检查，不需要额外拉取仓库；
• 对于Pipeline方案，也可以用git diff ${lastCommit} ${currentCommit}来检查具体的变更内容，实现更精细的判断（比如只在特定目录变更时执行预构建）；
• 存储上次提交哈希的方式可以灵活调整，比如用Jenkins的全局参数、项目的自定义参数，或者存储在Git仓库的特定文件中（适合多节点Jenkins环境）。

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