AIGC标识 接口幂等:三种实现与它们各自的代价

用户点了两次提交、网关超时后重试、消息队列重复投递——这三种情况都会让同一个请求到达两次。幂等要解决的,就是“执行两次”与“执行一次”的结果必须一致。

方案一,唯一键去重。客户端或服务端生成一个请求唯一标识,服务端在执行业务前先检查该标识是否已处理过,处理过就直接返回上次结果。实现简单,适用范围广。

图片7

代价在于“存多久”和“存哪里”。标识需要落库或落缓存,过期时间要覆盖最长重试窗口;如果只放内存,服务重启就失效。并发情况下,“检查 + 写入”必须是原子操作,否则两个请求会同时通过检查。

方案二,业务状态机。把“重复请求”变成“非法状态迁移”。比如订单只有从“待支付”才能进“已支付”,第二次支付请求会因为状态不符被拒绝。这种方式不依赖额外的去重表,天然贴合业务。

代价在于设计成本。状态机要求把每一步的状态与允许的迁移写清楚,遇到跨实体的操作(扣库存与创建订单)时,还需要考虑补偿。业务一旦不规整,状态机就难以覆盖。

方案三,数据库唯一约束。利用唯一索引让重复插入直接失败,再捕获异常返回成功。这种方式最“硬”,不依赖应用层判断。

代价在于异常处理与语义。唯一冲突的报错需要转成业务语义,否则调用方会以为是系统故障;另外它只防“插入重复”,防不了“更新重复”,更新场景仍需唯一键配合。

三种方案经常被组合使用:入口层用唯一键拦截重复请求,业务层用状态机保证迁移正确,存储层用唯一约束兜底。三层各有分工,缺一层就会在某个边界上漏。

还有几个实践细节值得写下来。第一,幂等的返回应当是“上次的成功结果”,而不是“重复请求已被忽略”,否则调用方无法区分成功与失败;第二,写操作的幂等键要与业务实体绑定,不能只用时间戳;第三,测试时要专门模拟“并发双请求”,串行测试永远发现不了原子性问题。

一句话总结:幂等不是加一个字段,而是把“请求唯一性”和“状态正确性”分开设计。前者防重复,后者防错乱。

图片8

本文为工程技术实践分享,不含商业推广信息,不构成对任何产品或架构的建议;实现方案需结合业务一致性要求评估。

posted @ 2026-11-16 16:54  深入浅出技术栈  阅读(5)  评论(0)    收藏  举报