扣子外部API异常处理：重试与容错配置详解
遇到报错、节点变红、流程断裂——别急着往配置面板里堆节点。先暂停，精准定位异常类型，再针对性修复。常见故障源头无非三类：变量引用失败（下游强行读取未执行分支上的空值）；大模型节点输出波动（有时返回JSON，有时生成纯文本，偶尔超时）；外部API返回401、403、503等具体状态码。混合使用方案只会让故障面扩大，因此第一步必须是异常分类。
扣子工作流调用外部API时频繁中断、节点报错、分支未执行即失败——这不是配置疏漏，而是缺少按错误类型分级响应的重试路径和空值兜底结构。
识别三类必须区分处理的异常源头
先确认你遇到的是哪一类问题，再针对性解决：变量引用失败（下游强行读取未执行分支的空值）；大模型节点输出不稳定（JSON/纯文本/超时交替出现）；外部API返回401/403/503等具体状态码。方案混用只会让故障面扩大，因此第一步必须是异常分类。
多分支空值问题：用变量聚合节点强制收敛
方法一：插入变量聚合节点（推荐）
将所有分支的输出线全部连接到同一个【变量聚合节点】；在该节点中设置统一输出变量名，例如【output_result】；勾选“取第一个非空值”选项。这样无论哪条分支实际执行，下游都只读取该变量，不会因空值中断。
注意：变量聚合节点不能替代逻辑判断，它仅保证数据流“不断链”，业务含义仍需在后续节点中校验。
大模型节点不稳定：Prompt约束 + JSON校验 + 分支重试三重兜底
第一步，在大模型节点的Prompt中明确要求输出纯JSON格式，开头添加一句：“仅输出合法JSON，不要任何解释性文字、markdown符号或换行”。
第二步，紧接在大模型节点后插入一个【代码节点】，用Python校验输出是否为有效JSON：import json; json.loads(input.get("response", "{}"))
第三步，将代码节点的【错误分支】连回大模型节点，形成闭环重试；
第四步，在大模型节点设置【最大重试次数=2】，防止无限循环；
第五步，若重试后仍失败，在错误分支接入【固定返回节点】输出兜底文案，确保流程不卡死。
外部API调用失败：按HTTP状态码分级响应
方法1：401错误（token过期）→ 可刷新重试
在HTTP节点的【错误分支】接一个“调用另一个工作流”节点，指向专门刷新token的子工作流；子工作流成功后，用【变量聚合节点】合并新旧token，再原路触发原API请求。关键前提：必须在子工作流里原子更新凭证，否则并发请求会拿到过期token。
方法2：403错误（权限不足或签名失效）→ 不可重试
直接终止流程，触发【发送通知】节点向管理员推送告警，附带完整错误响应体。人工修正App权限配置或校验client_secret与签名密钥一致性后，再手动重启工作流。
方法3：5xx/429/超时 → 指数退避重试
扣子原生重试为固定间隔，不够灵活。可改用【延迟节点】+【条件分支】组合：第一次失败后延迟1秒，第二次失败后延迟2秒，第三次失败后延迟4秒。每次延迟后重新调用同一个HTTP节点，并在请求头中添加X-Retry-Count: {n}，便于服务端做限流识别。