如何在Jenkins多分支流水线中获取修改文件列表？SHA值相同问题处理

嘿，我碰到过类似的Jenkins多分支流水线问题，来给你捋捋怎么解决～你遇到的$PREVIOUS_COMMIT和$COMMIT SHA一致的情况，大概率是这两种场景之一：

• 这是当前分支的第一个提交，没有可对比的上一个提交，Jenkins会把两个变量设为同一个值；
• 如果是PR（拉取请求）构建，默认的$PREVIOUS_COMMIT可能不是你期望的目标分支提交，导致对比无效。

下面给你几个靠谱的解决方案，按需选择：

方案1：用Git命令处理边界场景 #

先在流水线里加个调试步骤，确认两个变量的具体值，方便排查：

stage('Debug Commit SHA') {
    steps {
        echo "PREVIOUS_COMMIT: ${env.PREVIOUS_COMMIT}"
        echo "COMMIT: ${env.COMMIT}"
    }
}

然后根据场景调整Git命令：

• 如果是第一个提交：对比Git的空树（固定SHA 4b825dc642cb6eb9a060e54bf8d69288fbee4904），拿到所有文件：

  sh "git diff 4b825dc642cb6eb9a060e54bf8d69288fbee4904 ${env.COMMIT} --name-only"
  

• 如果是PR构建：直接对比PR的目标分支和当前提交：

  sh "git diff origin/${env.CHANGE_TARGET} HEAD --name-only"
  

• 普通分支构建：先判断两个SHA是否一致，再执行对应命令：

  stage('Get Modified Files') {
      steps {
          script {
              def diffCmd
              if (env.PREVIOUS_COMMIT == env.COMMIT) {
                  diffCmd = "git diff 4b825dc642cb6eb9a060e54bf8d69288fbee4904 ${env.COMMIT} --name-only"
              } else {
                  diffCmd = "git diff ${env.PREVIOUS_COMMIT} ${env.COMMIT} --name-only"
              }
              def modifiedFiles = sh(script: diffCmd, returnStdout: true).trim().split('\n')
              echo "Modified files: ${modifiedFiles}"
          }
      }
  }
  

方案2：用Jenkins内置的变更集对象（更省心） #

Jenkins流水线本身提供了currentBuild.changeSets对象，可以直接获取变更文件，不需要手动执行Git命令，还能避免SHA不一致的问题：

stage('Get Changes via Jenkins SCM') {
    steps {
        script {
            def modifiedFiles = []
            // 遍历所有变更集（多分支流水线通常只有一个）
            currentBuild.changeSets.each { changeSet ->
                changeSet.items.each { change ->
                    // 收集所有受影响的文件路径
                    change.affectedFiles.each { file ->
                        modifiedFiles.add(file.path)
                    }
                }
            }
            // 去重后输出
            echo "Modified files: ${modifiedFiles.unique()}"
        }
    }
}

这个方法的优势是不需要关心Git命令的细节，Jenkins已经帮你处理了分支、PR等场景的变更跟踪，适合大多数常规流水线。

额外提示 #

如果碰到强制推送（force push）导致提交历史断层的情况，$PREVIOUS_COMMIT可能会和当前提交没有直接关联，这时候可以用git log --oneline -10查看提交历史，手动指定对比的基准提交，或者用git diff HEAD~1 HEAD --name-only（如果确定只有一个新提交的话）。

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