Jenkins构建中获取指定文件夹最新提交Hash异常问题

我来帮你分析下这个问题，本地执行正常但Jenkins里出问题，大概率是工作目录不匹配或者Git克隆配置的问题，咱们一步步排查解决：

1. 先确认Jenkins的工作目录是否正确 #

你在Groovy里用了dir("${prj}")切换目录，但这个目录不一定是Git仓库的根目录。Git命令要正确识别com.itextpdf这样的路径，必须在仓库根目录下执行。

你可以在dir块里加两行验证命令，看看当前路径是不是仓库根：

dir("${prj}") {
    echo "Getting last commits in manually numbered plugins"
    // 新增：打印Git仓库根目录和当前工作路径
    bat script: "${gitTool} rev-parse --show-toplevel"
    bat script: "cd" // Windows下显示当前目录
    manuallyNumberedPlugins.each{
        echo "plugin: $it"
        String output = "${TEST_TEMP_DIR}/${it}.lastCommit"
        bat script: "${gitTool} log --no-merges -1 --pretty=format:%%H --output=$output -- $it"
    }
    echo "Done"
}

如果rev-parse输出的路径和cd的结果不一致，说明你切换的${prj}不是Git仓库根，得调整prj变量指向正确的仓库根目录。

2. 检查指定文件夹的路径是否存在 #

Jenkins工作区里的com.itextpdf文件夹可能因为构建步骤、路径拼写问题不存在。可以在遍历插件时加个目录检查：

manuallyNumberedPlugins.each{
    echo "plugin: $it"
    // 新增：检查文件夹是否存在
    bat script: "dir $it"
    String output = "${TEST_TEMP_DIR}/${it}.lastCommit"
    bat script: "${gitTool} log --no-merges -1 --pretty=format:%%H --output=$output -- $it"
}

如果dir命令报错找不到文件夹，那就是路径拼写错了，或者工作区里该文件夹被误删了。

3. 检查Jenkins的Git克隆配置 #

如果你的Jenkins用了浅克隆（Shallow Clone），可能会导致Git无法获取到指定文件夹的历史提交，只能返回仓库全局的最新提交。

去Jenkins项目的「源码管理」配置里，看看是否勾选了"浅克隆"选项：

• 如果勾选了，取消它；或者把克隆深度调大（比如设为100），确保能覆盖到com.itextpdf文件夹的最新提交历史。

4. 简化命令先验证输出 #

先去掉--output参数，直接打印命令结果，看看是不是能拿到正确的Hash：

manuallyNumberedPlugins.each{
    echo "plugin: $it"
    // 直接打印结果，不写入文件
    def commitHash = bat script: "${gitTool} log --no-merges -1 --pretty=format:%%H -- $it", returnStdout: true
    echo "Got hash for $it: ${commitHash.trim()}"
    // 再写入文件
    String output = "${TEST_TEMP_DIR}/${it}.lastCommit"
    bat script: "echo ${commitHash.trim()} > $output"
}

如果直接打印能拿到正确的Hash，那说明--output参数在Jenkins的bat环境里有兼容问题，改用echo写入文件就可以解决。

5. 优化路径分隔符（可选） #

Windows下路径分隔符用\，但你脚本里用了/，虽然Git能识别，但为了稳妥，可以用Groovy的File类来构建路径：

def outputFile = new File(TEST_TEMP_DIR, "${it}.lastCommit")
String output = outputFile.getAbsolutePath() // 自动生成Windows风格的路径

按照上面的步骤排查，应该就能解决问题了。

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