使用GraphListener能否检测运行中Jenkins声明式流水线的阶段失败？

常见排查误区对应原因 #

你之前尝试的方案失效的核心原因，是对Pipeline节点的状态绑定规则认知有偏差：

• 携带ErrorAction的节点匹配失败：ErrorAction是Freestyle构建体系下的错误标记，Pipeline执行节点的未捕获异常，默认不会绑定该Action。
• 前置跳过的AtomNode检测失效：这类节点仅对应被主动标记为跳过的场景，不匹配执行过程中抛出异常的失败节点。
• rawBuild.result 为 null 是正常现象：该字段仅在整个Pipeline执行完成、最终状态落盘时才会赋值，执行中途实时监听场景下永远读不到有效值。
• 排查currentBuild、Executor等公共字段无结果：这类对象的状态都是全局构建维度的，本身不存储阶段级别的细分执行状态。

执行过程中实时检测阶段失败的可行方法 #

你使用的GraphListener.Synchronous是完全正确的切入点，只需要调整节点匹配逻辑即可：

• 核心匹配锚点是节点关联的ExceptionAction：CPS引擎在执行节点抛出未捕获异常时，会给对应的StepNode/AtomNode绑定该Action，不需要等整个构建完成。
• 阶段上下文匹配逻辑：从捕获到ExceptionAction的节点出发，沿着父节点链向上遍历，找到最近的绑定StageAction的节点，即可拿到当前异常所属的阶段名称——这个过程完全在节点抛出异常的瞬间触发，早于Pipeline全局状态赋值、早于后续跳过阶段的逻辑执行，满足实时检测要求。
• 注意：Declarative Pipeline的阶段元信息不会直接存在异常Action上，必须通过父节点链遍历完成上下文关联，引擎不会主动维护"异常-阶段"的映射关系。

CpsScript与CpsFlowExecution的可访问性 #

• CpsScript作为脚本执行代理对象，本身不存储任何阶段执行状态，所有运行时上下文都托管在CpsFlowExecution中。
• CpsFlowExecution存在公开可访问的执行上下文字段，不需要反射读取私有值：
  • 可通过公开方法getHeads()获取当前所有活跃执行分支的状态，当阶段执行失败时，对应分支的执行头会被标记为终止状态，关联的异常对象可以通过对应的ExecutionEnvironment获取。
  • 可通过公开方法getExecutionContext()获取当前步骤的执行上下文，配合节点遍历逻辑完成阶段与异常的关联。
• 注意：引擎本身不会在CpsFlowExecution中专门维护"失败阶段"的结构化列表，你需要自行基于执行上下文、节点关系完成匹配。

是否需要开发专属插件 #

• 常规需求不需要从零开发底层能力：实时检测阶段失败、触发自定义通知/拦截逻辑，仅需要实现GraphListener.Synchronous扩展点，基于现有workflow-cps、pipeline-stage插件的公开API即可完成，不需要对接CPS引擎底层逻辑。
• 仅当你需要自定义异常传播规则、修改CPS引擎的阶段状态流转逻辑时，才需要深入引擎层做定制开发，绝大多数业务场景下现有公开API完全覆盖需求。

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