You need to enable JavaScript to run this app. Jenkins Pipeline中retry块搭配timeout步骤时仅执行一次不触发重试
优惠活动
大模型
产品
解决方案
定价
更多

Jenkins Pipeline中retry块搭配timeout步骤时仅执行一次不触发重试

Jenkins Pipeline 中 retry 嵌套 timeout 仅执行一次的原因与解决方案

核心原因

  • 此前测试中retry搭配echo、error步骤可正常重试,是因为error步骤默认抛出普通运行时异常,属于retry默认可捕获的异常范围。
  • 当retry内部嵌套timeout步骤时,超时触发后抛出的是FlowInterruptedException类型的流程中断异常,这类异常默认携带Pipeline终止标记。
  • retry步骤在默认配置下仅捕获普通运行时异常,不会识别捕获流程中断类异常,因此无法触发后续的重试计数逻辑,直接将异常向上抛出,最终Pipeline被ABORTED终止,表现为retry仅执行一次就停止。
    你提供的运行日志也能佐证这一点:日志中timeout超时流程结束后,直接走完了retry块的结束标签,没有进入下一轮重试循环。

可落地的解决方法

根据实际业务需求,可选择以下任意一种方案实现重试逻辑:

方案1:显式开启retry的中断异常捕获开关

retry步骤从Pipeline 2.1版本开始支持catchInterruptions参数,默认值为false(不捕获中断类异常)。只要将该参数设置为true,retry就能正常捕获timeout抛出的超时中断异常,触发重试。
修改后的Pipeline示例代码:

pipeline {
    agent any
    stages {
        stage("Deploy") {
            steps {
                // 开启捕获中断异常能力,匹配timeout抛出的超时中断
                retry(3, catchInterruptions: true) {
                    timeout(time: 1, unit: 'SECONDS') {
                        sleep 3
                    }
                }
                echo "after timeout"
            }
        }
    }
}

注意:开启全局catchInterruptions: true后,所有触发FlowInterruptedException的场景(比如人为手动终止Pipeline)都会被retry捕获重试,需要根据实际场景评估是否适合使用。

方案2:捕获超时异常转换为普通异常供retry识别

如果需要精确区分「超时需要重试」和「手动终止不需要重试」的场景,可以在retry块内部用try-catch包裹timeout步骤,识别到超时类中断时,将异常转换为普通运行时异常,让retry正常捕获重试。
对应的Pipeline示例代码:

pipeline {
    agent any
    stages {
        stage("Deploy") {
            steps {
                retry(3) {
                    try {
                        timeout(time: 1, unit: 'SECONDS') {
                            sleep 3
                        }
                    } catch (FlowInterruptedException e) {
                        // 仅识别超时触发的中断,转换为可被retry捕获的普通异常
                        if (e.causes.any { it instanceof TimeoutStepExecution.ExceededTimeout }) {
                            echo "单次执行超时,准备进入重试流程"
                            throw new RuntimeException("单次执行超时触发重试", e)
                        }
                        // 其他类型的中断(如手动终止)直接抛出,不触发重试
                        throw e
                    }
                }
                echo "after timeout"
            }
        }
    }
}

嵌套顺序注意事项

  • 如果需求是为每一次重试单独配置超时时间:请保持retry外层、timeout内层的嵌套结构,配合上述两种方案实现重试逻辑。
  • 如果需求是为整个重试流程配置总超时(不管重试几次,总时长不超过阈值):需要将timeout放在retry外层作为总超时控制,这种场景下超时触发的中断会直接终止整个流程,不需要额外配置retry的异常捕获参数。

内容的提问来源于stack exchange,提问作者user630702

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 11:54:04