通过实际业务场景理解后端接口的幂等性

Posted 2022-11-28 leeon_l

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

非幂等场景：
服务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状态为『处理成功』；

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

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

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

写在最后：幂等性应用的场景还有很多，实现也有很多方式，更有很多需要考虑的问题，随着工作学习的深入，理解也一定会越来越深入的，加油！

博客搬家：https://segmentfault.com/blog/leeonfancy