Celigo 流程失败时如何系统诊断并修复（全失败/部分错误…

当 Celigo flow 失败、报错、返回空数据或运行缓慢时，按问题分类、错误分组、请求响应检查、执行日志追踪的步骤定位并修复。

适用场景

解决思路

1. 先看最近一次 job 状态：运行 `celigo jobs list --flow <flowId> --limit 1`、`celigo jobs get <jobId>`、`celigo jobs current --flow <flowId>`，关注 `status`、`numError`、`numSuccess`、`numIgnore`、`numPagesGenerated`、`numPagesProcessed`、`startedAt`、`endedAt`；若 `failed` 且 `numPagesGenerated: 0` 说明 export 阶段失败，不要去看 import 错误；若 `completed` 且 `numError > 0` 说明是记录级部分失败。
2. 判断问题类别：全失败（job `failed`、0 成功记录，通常 `numPagesGenerated: 0` 或首页 `numPagesProcessed: 0`，常见原因是连接失败、export 查询错误、资源缺失、权限不足）；部分失败（`completed` 但 `numError > 0`，常见原因是目标端校验错误、重复键、记录级 lookup 失败、限流、数据问题）；空跑（成功且 0 错误 0 记录，常见原因是 `resourcePath` 错误、delta 无变化、输出过滤过严、源查询无结果、webhook 无事件）；卡住/长时间运行（`running` 或 `retrying` 过久，常见原因是无分页的大数据集、目标系统慢、脚本 hook 逻辑长、on-premise agent 连接问题、限流退避）；间歇性失败（token/session 中途过期、限流、瞬时网络错误、源系统维护窗口）。
3. 对错误分类以决定动作：需要调查类（HTTP 400、401、403、404、405、409、422）应停下检查资源配置、连接状态、权限；瞬时类（408、429、500、502、503、504）先重试一次，再失败则升级；配置错误类按错误信息修复配置后重试；不在列表中的 5xx 仍按瞬时处理，不在列表中的 4xx 需人工复核。

适用边界 · 注意事项

• 该技能依赖 Celigo CLI（`celigo` 命令）和 Celigo 平台特有的 flow/job/error 概念，不适用于其他 iPaaS 或自建集成系统。
• 需要访问 Celigo 账号、flow 配置和运行数据；没有相应凭据或权限时无法执行诊断命令。
• 执行日志、debug 请求等调试能力受 Celigo 平台保留期限和功能可用性限制，日志过期或功能不可用时需改用其他手段。

经验正文