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
相关产品推荐
相关产品推荐

