TOC一、接口失败后不要把所有请求一起重发网络断开、权限错误、物料缺失和单号冲突处理方式不同。重试策略的目标是恢复可以恢复的任务同时把需要人处理的错误留下来。本文根据自己的对接项目错误分类和队列实现说明设计方法。示例是代码层面的处理建议不是金蝶所有版本统一的错误码说明也没有新增真实账套写入测试。二、先记录失败发生在哪个阶段同一张单可能保存成功、提交失败或提交成功、审核失败。仅记录“推送失败”不足以决定下一步。阶段需要保留的信息登录连接、时间、失败类型查询查询条件、目标账套、返回结果保存来源标识、目标内码和单号提交操作对象、结果和报错审核操作对象、最终业务状态阶段恢复应从已经确认的结果继续。保存后的审核失败不应直接把整张单当作全新单据再保存一遍。三、错误至少分成六组类别一般处理思路网络连接失败延迟后有限重试若请求可能已发出先确认目标结果超时或服务端异常写操作结果可能不确定先查询目标再决定临时锁或并发冲突确认属于暂时冲突后退避重试登录、授权、许可问题停止盲目重复检查配置或恢复认证字段校验或基础资料问题挂起修正数据后补处理同号冲突或未知错误核对目标内容保留人工处理入口这里是分类框架不能只凭 HTTP 状态码决定所有动作。服务端返回错误并不总能证明此前没有写入。项目当前使用消息关键词作为分类起点但关键词会受版本和语言影响。例如含“许可”的文案未必意味着密码错误含“超时”的消息也未必是网络超时。应结合阶段、结构化返回及目标查询来确认。四、超时先标记结果不确定典型情况是目标保存成功响应还没到客户端就断了。此时再次创建可能生成重复单。更可靠的流程是写请求超时 → 记录结果不确定 → 按来源标识查询目标 → 已存在核对内容及业务状态继续后续阶段 → 未找到按接口一致性和查询规则再次确认 → 确认可重发后进入受控重试如果目标查询失败不能把“没查到结果”当成“没有单据”。如果目标查询存在可见延迟也不能仅凭一次空结果马上重发。查询命中后还要确认是否是同一来源单并核对金额和关键字段。单号碰巧相同不能证明同步正确。五、重试需要退避、次数上限和到期时间每秒重发几十次会增加拥堵。可以采用指数退避并加入随机抖动让多个失败任务错开。function retryDelayMs(attempt, random Math.random) { if (!Number.isInteger(attempt) || attempt 0) { throw new Error(attempt 必须是非负整数); } const base 1000; const cap 60000; const upper Math.min(cap, base * 2 ** Math.min(attempt, 16)); return Math.floor(random() * upper); }这是调度延迟示例不是完整重试客户端。是否允许重试要在调用它之前决定。如果接口提供重试等待指引还需要按对应规则处理。任务还应记录尝试次数、下次执行时间、首次失败时间和最后错误。到达次数或时间上限后转入待处理状态而不是永远自动循环。六、会话失效和账号配置错误要分开会话到期可能在重新认证后恢复密码、授权或许可配置错误则需要处理根因。将两者都写成无限重新登录会隐藏问题也可能造成大量无效请求。可以限定重新认证次数并避免多个工作线程同时发起登录。重新认证后写操作仍要确认上一次执行结果不能因为登录成功就认定上一张单没有保存。具体认证方式应按当前部署版本和应用配置确认本文不提供统一登录参数。七、人工补处理也要保留原来的任务身份修复客户编码后点击重推应该恢复原业务任务而不是生成一个失去来源关联的新任务。至少保留来源标识、目标连接、失败阶段、历史尝试记录和处理人。若保存阶段已经成功保留目标内码供后续操作使用。基础资料修复后还需确认报文是否过时来源可能在失败期间改过价格或被取消。恢复时应按照约定选择最新内容或原版本并留记录。八、如何确认重试机制真的有效在隔离测试环境设计这些场景逐项核对日志和目标结果场景要验证的结果网络暂时不可用任务延迟后恢复尝试次数有上限缺少物料挂起并显示编码不持续刷请求保存成功后响应丢失恢复时识别目标避免重复创建审核失败从已保存对象继续处理不新建重复单查询目标失败保留结果不确定不判为空单进程重启任务及重试进度仍可恢复测试是否通过需要实际执行后填写不能用代码看起来合理替代结果。九、值守时看异常积压不只看重试次数同一种错误连续出现往往需要检查公共配置或系统状态。很多张单同时缺少同一个客户编码不值得逐张重试。应按错误类别和连接汇总显示待处理数量、最早失败时间及负责人。这样财务和实施人员知道先处理什么而不是面对一长串相同报错。重试不是为了让日志变绿而是让一张业务单据恢复到约定状态。最终验收仍要看目标内容和业务状态。有接口失败问题可以在评论区说明发生在保存、提交还是审核阶段并贴脱敏后的错误片段。不要贴账号密码、token或完整客户报文。