接口失败重试怎么设计？

接口失败重试要先判断失败类型，再决定是否自动重试。春喜铜平台里，企微通知失败和库存写入失败不是一个风险等级；网络超时和字段不合法也不能用同一套重试办法。重试设计不清，轻则消息重复，重则订单、库存或审批状态被重复写入。

先区分失败原因

常见失败可以分成几类：

• 网络波动、对方系统暂时不可用，可以按次数和间隔重试。
• 字段缺失、格式错误、枚举值不匹配，不应反复重试，应退回修正。
• 对方返回部分成功，要按明细判断哪些已写入、哪些未处理。
• 重复请求或重复单号，要先做幂等判断，不能直接再写一次。
• 涉及价格、库存、财务或客户承诺的失败，要有人工介入入口。

接口失败不要只显示“失败”，要把失败原因写到业务人员能判断下一步的程度。

重试必须有幂等依据

自动重试前要确认唯一业务编号、接口批次、请求指纹或外部流水号。没有幂等依据的接口，只能谨慎重试，必要时转人工确认。

重试规则要写清次数、间隔、退避方式、超限后通知对象和人工处理入口。不要无限重试，也不要所有失败都马上重试。短时间高频重试可能压垮对方系统，或把同一异常放大成一堆重复数据。

人工处理要留下链路

接口转人工后，要记录处理人、处理时间、处理方式、是否补录、是否回滚、是否通知对方系统。人工补录的数据要关联原接口失败记录，不能变成一条孤立数据。

重试关闭前要确认最终状态：成功、放弃、人工补录、等待对方、已回滚或另建异常。这样后续看日志时，才能知道失败是不是已经真正处理完。