Jenkins捕获异常返回null而非错误，如何获取异常根源？

这种情况我之前也碰到过——Jenkins Pipeline里捕获到的异常经常被上层框架（比如Artifactory插件）包装成通用异常，直接调用getMessage()或者getCause()往往拿不到命令行里能看到的真实编译错误。试试下面这些方法来深挖异常根源：

1. 打印完整的异常链 #

真实的编译错误通常藏在多层嵌套的异常链里，直接取顶层异常的信息自然会返回null。可以写一个小方法遍历整个异常链，把每一层的异常信息都打印出来：

def printFullException(Throwable err) {
    globalVar.echo "=== Full Exception Chain ==="
    Throwable currentErr = err
    int depth = 0
    while (currentErr != null) {
        globalVar.echo "Depth ${depth}: [${currentErr.getClass().name}] ${currentErr.getMessage() ?: 'No message'}"
        // 可选：打印栈轨迹，方便定位问题
        currentErr.stackTrace.each { elem ->
            globalVar.echo "    at ${elem.toString()}"
        }
        currentErr = currentErr.cause
        depth++
    }
}

然后在你的catch块里调用这个方法：

catch(Throwable err) { 
    globalVar.echo "TEST#" 
    globalVar.echo "TEST#" 
    // 调用方法打印完整异常信息
    printFullException(err)
    globalVar.echo "TESTSSSS" 
    throw err 
}

2. 直接输出完整的异常栈轨迹 #

如果不想写遍历方法，也可以直接用Java的printStackTrace()把整个异常的详细信息输出到Jenkins控制台：

catch(Throwable err) { 
    globalVar.echo "TEST#" 
    globalVar.echo "TEST#" 
    // 把异常栈信息写入字符串后输出
    def stringWriter = new StringWriter()
    def printWriter = new PrintWriter(stringWriter)
    err.printStackTrace(printWriter)
    globalVar.echo "=== Exception Details ===\n${stringWriter.toString()}"
    globalVar.echo "TESTSSSS" 
    throw err 
}

这样会输出所有嵌套异常的类名、错误信息和完整栈轨迹，你就能找到命令行里看到的incompatible types错误了。

3. 确保Gradle任务输出完整日志 #

有时候真实的编译错误其实已经被Gradle输出了，但被Jenkins的日志过滤或者淹没了。可以在执行Gradle任务时开启更详细的日志：

• 给Gradle命令加上--info参数（比默认日志更详细）或者--debug参数（会输出大量调试信息，适合排查复杂问题）
• 如果用ArtifactoryGradleBuild步骤，可以在配置里指定日志级别，确保编译错误被完整打印

为什么会出现这种情况？ #

你看到的hudson.model.Run$RunnerAbortedException是Jenkins或者Artifactory插件抛出的包装异常，它本身只是用来标记任务终止，并没有携带真实的编译错误信息。真实的错误被嵌套在这个异常的cause链中，所以直接调用err.getMessage()会返回null，必须遍历整个异常链才能找到根源。

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