Novu框架中跳过步骤导致后续步骤执行失败的问题分析

问题背景

在使用Novu工作流框架时，开发人员发现当工作流中的某个步骤被跳过(skip)后，后续步骤的执行会出现异常。这个问题不仅出现在inApp类型的步骤中，也出现在自定义(custom)步骤中。

问题现象

具体表现为：当一个步骤被配置了skip条件并且条件满足时，框架会尝试验证该步骤的输出结果，但由于步骤实际上被跳过了，没有产生有效的输出数据，导致验证失败。错误信息会提示"Workflow has an invalid state"和"must have required property"等验证错误。

技术分析

问题的根本原因在于框架的执行逻辑存在缺陷。在executeStepFactory函数中，skip检查只在实际执行步骤时进行，而在步骤状态恢复(hydration)时没有进行相应的处理。这导致框架在恢复工作流状态时，会错误地尝试验证被跳过步骤的输出结果。

对于自定义步骤(custom step)而言，当配置了输出模式(outputSchema)并且步骤被跳过时，框架会尝试验证一个不存在的输出结果，从而产生验证错误。

解决方案探讨

目前有两种可能的解决方案：

1. 简单方案：在步骤状态恢复时也进行skip检查。但这种方法要求开发者的skip函数必须是幂等的，即在多次调用时产生相同的结果。

2. 完整方案：修改框架的桥接层(bridge)，使其能够正确传递步骤被跳过的状态信息。这需要在工作流状态映射(mapState)中包含步骤的跳过状态，并确保工作流引擎能够正确处理这种状态。

值得注意的是，当前框架中已经存在JobStatusEnum.SKIPPED枚举值，但没有找到明确使用它的地方。相反，当isBridgeSkipped为true时，工作流会将任务标记为CANCELED而非SKIPPED，这表明框架在状态处理上可能存在不一致性。

影响范围

这个问题会影响所有使用步骤跳过功能的工作流，特别是：

• 使用inApp步骤并配置skip条件的工作流
• 使用自定义步骤并定义输出模式的工作流
• 需要根据运行时条件动态跳过某些步骤的复杂工作流

最佳实践建议

在问题修复前，开发人员可以采取以下临时解决方案：

1. 避免在可能被跳过的步骤上定义严格的输出模式
2. 在skip函数中确保幂等性
3. 考虑使用条件分支而非步骤跳过来实现类似逻辑

总结

Novu框架中的步骤跳过功能存在状态处理不完善的问题，这会导致后续步骤执行失败。该问题涉及框架核心的执行逻辑和状态管理机制，需要从架构层面进行改进。开发团队需要权衡简单修复和完整架构调整的方案，同时确保不影响现有工作流的兼容性。