Gradle获取Git信息任务在Jenkins上无法执行求助

问题背景 #

本地运行Gradle任务可正常通过自定义函数获取Git分支信息，但在Jenkins上始终返回默认值Unknown git information，控制台无报错，Jenkins已安装Git插件。

解决方案步骤 #

1. 修正Gradle任务的执行阶段 #

当前getGitInformation任务的代码在配置阶段执行（Gradle加载任务定义时就运行），若Jenkins的Git代码拉取在后续步骤，配置阶段时仓库可能未准备完成。将代码移至doLast块，确保在任务执行阶段运行：

task getGitInformation {
    doLast {
        System.setProperty("GIT_BRANCH", git('git rev-parse --abbrev-ref HEAD'))
    }
}

2. 修复Git命令的工作目录与错误日志 #

不要直接指向.git子目录，git命令应在仓库根目录执行；同时添加错误输出捕获，方便排查问题：

def git(command) {
    def gitCommandResult = "Unknown git information"
    try {
        def workingDir = rootDir // 使用项目根目录作为工作目录
        def result = command.execute(null, workingDir)
        def errorOutput = result.err.text.trim() // 捕获错误输出
        result.waitFor()
        
        if (result.exitValue() == 0) {
            gitCommandResult = result.text.trim()
        } else {
            logger.error("Git命令执行失败: ${command}, 错误信息: ${errorOutput}")
        }
    } catch (Exception e) {
        logger.error('无法通过Git命令获取信息', e)
    }
    return gitCommandResult
}

3. 确保Jenkins环境可找到Git命令 #

Jenkins环境中Git可执行文件可能不在默认PATH内，可通过两种方式解决：

• 在Jenkins全局工具配置中指定Git安装路径，然后在函数中使用绝对路径调用：

  def gitCommandPath = '/usr/bin/git' // 根据Jenkins服务器实际路径调整
  def result = "${gitCommandPath} ${command}".execute(null, workingDir)
  

• 在Jenkins构建环境中添加环境变量，将Git的bin目录加入PATH。

4. 检查Jenkins工作区权限 #

确保Jenkins运行用户对项目工作目录（含.git目录）有读写权限。可在Jenkins构建步骤中添加shell/batch命令验证：

• Linux：ls -la .git
• Windows：dir .git

5. 直接复用Jenkins内置Git环境变量 #

Jenkins拉取Git代码后会自动生成GIT_BRANCH、GIT_COMMIT等环境变量，可直接读取替代自定义Git命令，既避免执行问题又兼容本地运行：

task getGitInformation {
    doLast {
        def gitBranch = System.getenv("GIT_BRANCH") ?: git('git rev-parse --abbrev-ref HEAD')
        System.setProperty("GIT_BRANCH", gitBranch)
    }
}

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