Jenkins声明式Groovy流水线超时后变量丢失及序列化异常求助

这个问题我之前帮团队排查过，核心是Jenkins流水线的序列化机制在搞鬼：当流水线触发超时异常进入catch块时，hudson.model.User这类不可序列化的对象会被Jenkins的持久化机制丢弃，连带导致env.BUILD_USER_ID这类上下文变量丢失，最终抛出NotSerializableException打断清理脚本执行。给你几个靠谱的解决办法：

1. 提前保存可序列化的用户信息 #

在流水线最开始就把需要的用户ID保存到普通字符串变量里（字符串是可序列化的，不会被丢弃），别依赖后续的env或者User对象：

#!/usr/bin/groovy
import com.vmware.jenkins.utils.JenkinsGroovyCommon

// 提前把用户ID存到可序列化的变量里
def savedUserId
wrap([$class: 'BuildUser']) {
    savedUserId = env.BUILD_USER_ID
}
print "DEBUG: parameter USERNAME = ${savedUserId}" // 这里能正常输出用户ID

2. 避免直接操作不可序列化的User对象 #

超时触发的异常是FlowInterruptedException，直接捕获这个类型并判断cause是否为超时，完全不用碰User对象，就能避开序列化问题：

stage ('Verify') {
    try {
        timeout(time: 2, unit: 'MINUTES') {
            print "${savedUserId}" // 用提前保存的变量，超时后依然可用
            print "Do some verification"
            // ... 你的验证逻辑代码
        }
    } catch(org.jenkinsci.plugins.workflow.steps.FlowInterruptedException err) {
        // 判断是否是超时导致的中断
        if(err.cause instanceof hudson.model.Timeout) {
            print "${savedUserId} - ${BUILD_URL} has reached timeout, failing build."
            def message = "${BUILD_URL} has reached an input timeout, failing build."
        }
        // 执行清理脚本，不会再抛出序列化异常
        try {
            sh '''
                echo "Do cleanup!"
                # 这里替换成你的实际清理命令，比如删除临时文件、终止进程等
            '''
        } catch (Exception e) {
            print "Failed to execute cleanup : " + e.getMessage()
        }
    } catch(Exception otherErr) {
        // 处理其他非超时的异常
        print "Unexpected error: " + otherErr.getMessage()
        // 可选：这里也可以执行清理
    }
}

3. 优化：用finally确保清理逻辑必执行 #

如果希望不管是超时、其他异常还是正常结束，清理逻辑都能运行，用finally块比嵌套try-catch更健壮：

stage ('Verify') {
    def cleanupDone = false
    try {
        timeout(time: 2, unit: 'MINUTES') {
            print "${savedUserId}"
            print "Do some verification"
            // ... 验证逻辑
        }
    } catch(org.jenkinsci.plugins.workflow.steps.FlowInterruptedException err) {
        if(err.cause instanceof hudson.model.Timeout) {
            print "${savedUserId} - ${BUILD_URL} timed out."
        }
        throw err // 重新抛出异常，保证构建标记为失败
    } catch(Exception otherErr) {
        print "Unexpected error: " + otherErr.getMessage()
        throw otherErr
    } finally {
        if(!cleanupDone) {
            try {
                sh '''
                    echo "Executing cleanup..."
                    # 你的清理命令
                '''
                cleanupDone = true
            } catch (Exception e) {
                print "Cleanup failed: " + e.getMessage()
            }
        }
    }
}

为什么这些方法有效？ #

• 提前保存的savedUserId是字符串，属于Jenkins支持的可序列化类型，上下文切换时不会丢失；
• 直接捕获特定异常并判断超时原因，完全避开了不可序列化的User对象，消除了NotSerializableException；
• finally块保证清理逻辑无论流水线执行状态如何都会触发，更符合“出错必清理”的需求。

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