YonLinker 接口幂等：安全重试、重放与业务对账
针对订单、凭证和库存消息设计业务键、处理状态与重放控制，防止网络重试造成重复业务结果。
学习目标
完成一个可重复发送但只产生一次业务结果的接口测试。
适用角色
业务所有者、数据或集成负责人、IT 运维、信息安全与审计
前置条件
- 相同消息多次提交只产生一次结果。
- 键冲突被阻止并告警。
- 重放有批准和完整审计。
完成检查
- 相同消息多次提交只产生一次结果。
- 键冲突被阻止并告警。
- 重放有批准和完整审计。
常见错误
- 用时间戳作为唯一键。
- 删除幂等记录过早。
- 整批重跑部分成功任务。
泰国项目提示
泰国落地需确认中英泰数据、THB/外币、Asia/Bangkok 时区、职责分离和留存；VAT、WHT、海关、BOI 及法定会计须由合格泰国专业人员按现行规定复核。
相关模块
03
操作步骤
01为每类消息选择稳定业务键并明确来源系统命名空间。
02保存接收、校验、处理、成功、拒绝和隔离状态及首次结果。
03同一键同一内容返回既有结果；同一键不同内容必须冲突告警。
04将传输重试与业务重放分开，重放须授权、范围和原因。
05对部分成功设计检查点和补偿动作，禁止整批盲目重跑。
06设置保留期覆盖最大重试窗口并监控键表容量。
07测试重复、并发、超时后成功、乱序及隔离后重放并对账。
- 01
为每类消息选择稳定业务键并明确来源系统命名空间。
- 02
保存接收、校验、处理、成功、拒绝和隔离状态及首次结果。
- 03
同一键同一内容返回既有结果；同一键不同内容必须冲突告警。
- 04
将传输重试与业务重放分开，重放须授权、范围和原因。
- 05
对部分成功设计检查点和补偿动作，禁止整批盲目重跑。
- 06
设置保留期覆盖最大重试窗口并监控键表容量。
- 07
测试重复、并发、超时后成功、乱序及隔离后重放并对账。
04
实施提示
- 相同消息多次提交只产生一次结果。
- 键冲突被阻止并告警。