Jenkins流水线中Groovy调用PowerShell无法捕获异常消息求助

问题原因 #

Jenkins的powershell步骤与PowerShell脚本的异常机制相互隔离：当PowerShell脚本抛出异常并返回非0退出码时，powershell步骤只会抛出一条通用异常，消息固定为script returned exit code 1，无法直接获取PowerShell内部的具体异常内容。

解决方案 #

要捕获PowerShell的异常消息，需要让PowerShell主动输出错误内容，再通过Jenkins的powershell步骤参数捕获输出，最后在Groovy中处理。

修改后的完整代码 #

def call() {
    node {
        timestamps {
            ansiColor('xterm') {
                try {
                    // 执行PowerShell脚本，同时捕获输出和退出状态
                    def psResult = powershell(
                        script: '''
                            $ErrorActionPreference = "Stop"
                            try {
                                throw new Exception("ERROR: This is a test Exception.")
                            } catch {
                                // 输出异常消息到标准输出
                                Write-Output $_.Exception.Message
                                // 返回非0退出码触发Jenkins的错误流程
                                exit 1
                            }
                        ''',
                        returnStdout: true,
                        returnStatus: true
                    )
                    
                    // 检查PowerShell退出码，非0则抛出包含错误消息的异常
                    if (psResult[1] != 0) {
                        throw new Exception(psResult[0].trim())
                    }
                } catch (error) {
                    println("Caught error: ${error.getMessage()}")
                }
            }
        }
    }
}

关键说明 #

• $ErrorActionPreference = "Stop"：设置PowerShell遇到错误立即终止，确保异常能被内部catch块捕获
• Write-Output $_.Exception.Message：将PowerShell的异常消息输出到标准输出，让Jenkins的powershell步骤能捕获到该内容
• returnStdout: true 和 returnStatus: true：让powershell步骤返回一个数组，第一个元素是脚本输出内容，第二个是退出码
• Groovy中检查退出码，手动抛出包含PowerShell错误消息的异常，这样外层catch块就能拿到具体的错误内容

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