如何使用幂等性识别重复提交

写在前面：之前在设计接口时因经验尚浅，并未过多考虑幂等性，但这两天出现的一个线上问题让我认识到了某些情况下接口幂等性 的重要性；

非幂等场景：

服务A将单据A信息通过RPC远程过程调用传给下游服务B接口（非幂等接口）用于生成关联单据B，服务B接口会校验是否已经接收 过单据A，如果已接收过，会报错『重复的单据』，如果未接收过，则生产关联单据B并写库，将结果返回服务A，服务A收到结果后 修改此单据状态，将结果返回客户端。简化流程图如下所示：

 

 

非幂等出现的问题：

服务A调用服务B后，服务B生成关联单据B写库成功，返回成功给服务A；但由于网络抖动，服务A未接收到服务B返回的响应，默认 认定失败，返回客户端失败；业务人员重试，但由于服务B已接受过此单据A，会抛出异常『重复单据A』，对于此单据A就永远无法 接受到单据B的成功响应，永远为『处理失败』状态，与实际状态不一致；（出现此问题后，首先确认单据A的关联单据B已生成，然 后手动修复服务A里单据A的状态为『处理成功』）

幂等性解决：

为了解决以上问题，就需要保证下游服务B接口对单据A维度做幂等性；判断再次接受到单据A之后，不做任何操作，直接返回成功即 可，服务A接受到成功后即可修改单据A状态为『处理成功』；

接口的幂等性实际上就是接口可重复调用，在调用方多次调用的情况下，接口最终得到的结果是一致的。有些接口可以天然的实现幂 等性，比如查询接口，对于查询来说，你查询一次和两次，对于系统来说，没有任何影响；但对于有写库操作的增删改接口，多次调 用就会对系统有多次影响。

实现幂等性的关键在于识别重复的请求，对重复的请求返回成功即可，无需再对系统造成影响；

 

实现幂等性后的简化流程图：