接口连通不等于业务闭环
接口联调通过,通常只能说明网络可达、参数能对上、返回格式正确。它不能证明一笔业务只处理了一次,也不能证明两边系统对同一笔业务的状态理解一致。
在正式接入前,应该先画出端到端的业务链路:谁发起、经过哪些系统、每一步写入什么数据、失败时停在哪里、由谁补偿。只有把链路跑通,接口才是真正可用的。
- 先选一条最关键的业务链路做端到端验证,而不是平均铺开所有接口。
- 确认双方对状态、金额、时间和唯一标识的定义完全一致。
- 把人工干预点标出来,明确异常时由业务还是技术处理。
重点处理三类数据问题
集成中最常见的问题不是接口报错,而是数据在异常和并发下发生偏差。第一类是重复:用户重复点击、消息重复投递、失败后重复重试,都会产生重复记录。第二类是顺序:先到的状态更新被后到的旧消息覆盖。第三类是失败:调用方以为成功,接收方其实没有落库。
对应的方法包括幂等键、状态机、重试策略和补偿任务。关键不是把所有异常都消灭,而是让异常发生时系统仍然知道发生了什么,并且可以安全地恢复。
- 写操作使用业务唯一键做幂等,避免重复提交产生多笔数据。
- 用状态机约束状态流转,拒绝不符合业务规则的跳转。
- 失败重试要有上限和退避,超过上限进入人工处理队列。
让问题可以被追踪
集成系统出了问题,最耗时的往往不是修复,而是定位:这笔数据从哪个系统来、经过了哪些处理、在哪一步失败。没有统一标识和日志,排查只能靠猜。
建议在请求入口生成链路标识,贯穿调用方、接口层、业务处理和落库日志。对关键链路补充成功率、延迟、积压和失败原因指标,再配合定时对账,才能把偶发问题变成可管理的信号。
- 为每次跨系统调用记录业务编号、链路编号和关键参数摘要。
- 区分可重试失败和不可重试失败,避免无效重试放大问题。
- 按业务周期做数据对账,发现两侧记录数量或状态不一致。
先做最小闭环,再扩展覆盖面
集成范围越大,不确定性越多。比较稳妥的做法是先完成一条最小闭环,让数据从起点走到终点,并验证异常、重试和对账,再把同一套模式复制到其他接口。
这样做的代价是前期看起来慢一些,但能更早发现定义不一致和边界问题。等基础链路稳定后,新增接口更多是重复已有模式,整体风险反而更低。