错误处理

功能说明

错误处理用于统一配置连接流动作节点失败后的重试、后续处理和 Webhook 告警。

错误处理可以应用到当前连接流的全部动作节点，也可以根据节点场景分别配置。

配置入口

进入连接流的错误处理设置，按业务可靠性和下游系统承受能力配置重试与失败策略。

错误处理设置包含重试、失败策略、告警和批量应用入口；运行值已脱敏

配置重试

启用重试

打开重试开关。只有适合重复执行的动作才建议重试。

配置重试次数

重试次数默认值为 3，可配置范围为 1–10。

配置重试间隔

重试间隔默认值为 5 秒，可配置范围为 1–60 秒。

配置退避因子

退避因子默认值为 1.5，可配置范围为 1–5。退避因子会影响后续重试的等待时间。

配置最大重试间隔

最大重试间隔默认值为 60 秒，可配置范围为 1–300 秒，用于限制退避后的单次等待时间。

重试次数、间隔、退避系数和最大重试间隔的当前表单

选择失败后的处理方式

返回错误

页面中的“返回错误”表示动作最终失败后把错误向流程返回。适用于后续节点依赖当前动作成功结果，或继续执行可能产生错误数据的场景。

忽略错误

页面中的“忽略错误”表示忽略当前错误并允许流程继续。只适用于当前动作失败不会破坏后续数据一致性的场景。

选择忽略并继续前，应检查后续节点是否引用当前动作的输出。

配置 Webhook 告警

错误处理当前使用 Webhook URL 发送告警，不直接提供独立的钉钉群、邮件或系统通知中心选项。

如需发送到钉钉、飞书、邮件或其他通知系统，应由告警 Webhook 对接相应服务，并在真实环境验证消息格式、鉴权、超时和失败处理。

Webhook URL 可能包含环境信息或访问凭证，截图和文档中必须脱敏。

应用到全部动作节点

启用“应用到本连接流的所有动作节点”后，当前错误处理配置会用于本连接流中的动作节点。

应用前应检查：

是否存在不允许重复执行的动作。

是否存在写入、创建、支付、发消息等可能产生重复副作用的动作。

不同下游系统是否需要不同的重试间隔。

忽略失败后，后续节点是否仍能获得有效输入。

对高风险动作，建议单独核对幂等条件，不要仅依赖统一重试。

配置示例

短暂网络错误

开启重试。

使用有限次数和退避间隔。

重试后仍失败时终止流程。

配置 Webhook 告警。

非关键通知失败

开启有限重试。

确认通知失败不会影响主业务结果后，可选择忽略并继续。

在告警接收端保留失败记录。

非幂等写入动作

先确认下游是否支持幂等键或重复请求识别。

无法保证幂等时，不应直接使用多次自动重试。

失败后优先终止流程并人工核对目标系统。

验证清单

重试次数、间隔、退避因子和最大间隔与页面保存值一致。

模拟失败后，实际重试次数符合配置。

“返回错误”的实际流程结果符合预期。

“忽略错误”只在满足条件时使用，且实际后续执行结果符合预期。

Webhook 接收端能收到脱敏的告警数据。

“应用到本连接流的所有动作节点”的范围与预期一致。

写入型动作已经验证幂等或重复执行风险。

常见问题

错误处理可以直接选择钉钉或邮件告警吗？

当前配置项是 Webhook URL。可以由 Webhook 接入钉钉、飞书、邮件或其他通知系统，但这些渠道不是错误处理页中的独立选项。

重试次数越多越好吗？

不是。重试会增加流程耗时和下游压力，非幂等动作还可能产生重复数据。应根据错误类型和下游限制设置。

什么时候可以选择忽略并继续？

只有在当前动作失败不会影响后续数据完整性，而且后续节点不依赖其有效输出时才应使用。

功能说明#

配置入口#

配置重试#

选择失败后的处理方式#

返回错误#

忽略错误#

配置 Webhook 告警#

应用到全部动作节点#

配置示例#

短暂网络错误#

非关键通知失败#

非幂等写入动作#

验证清单#

常见问题#