Gradle中获取Git分支名返回null致代码执行失败的问题排查

安全阿岳

2026-8-20

问题原因及解决办法

核心问题分析

你的代码返回null并触发toLowerCase()空指针错误，主要源于以下几点：

1. Git命令执行的工作目录不匹配

Gradle任务默认工作目录可能并非Git仓库根目录，导致git rev-parse --abbrev-ref HEAD命令执行失败，无标准输出返回，branch变量始终为null。

2. 未校验Git命令的执行状态

代码仅打印错误输出，但未判断命令的退出码。即便git命令因目录错误、权限问题等执行失败，也不会触发异常，直接返回null值。

3. 输出读取逻辑存在漏洞

如果git命令执行失败（只有错误输出，无标准输出），proc.in.eachLine不会执行赋值操作，branch保持初始的null状态，最终导致后续调用toLowerCase()报错。

修复后的代码

String branchName = gitBranchName()?.toLowerCase() ?: throw new IllegalStateException("无法获取Git分支信息")

String gitBranchName() {
    def branch = System.env.GIT_BRANCH
    if (!branch) {
        // 指定Git仓库根目录（若Gradle工作目录不是仓库根，需调整路径）
        def gitRepoDir = new File(System.getProperty("user.dir"))
        def proc = ["git", "rev-parse", "--abbrev-ref", "HEAD"].execute(null, gitRepoDir)
        
        def output = new StringBuilder()
        def errorLog = new StringBuilder()
        
        proc.in.eachLine { line -> output.append(line) }
        proc.err.eachLine { line -> errorLog.append(line) }
        
        proc.waitFor()
        
        if (proc.exitValue() != 0) {
            throw new IllegalStateException("Git命令执行失败: ${errorLog.toString()}")
        }
        
        branch = output.toString().trim()
    }
    return branch
}