发生了什么
用户更换订单里的商品后,后台会登记用户接下来可以使用的服务。系统把这样的使用资格记录叫作“权益”。一次更换本应只登记一份,这次却在同一笔订单下登记了两份。
事情起于一次后端改动:用户资料服务收不到部分订单的通知,开发要把这条通知补上。 开发在“更换商品”的处理程序里增加了发消息的代码,让程序在订单处理完成后通知用户资料服务。
本质
开发复用了已有的“支付成功”消息。但这种消息会被多段程序接收:用户资料服务会收到,另一段负责登记服务资格的程序也会收到。
于是,一次更换商品变成了下面的过程:
- 换品处理程序先为用户登记一份可使用的服务,这是它原本就会做的事。
- 新加的代码发出一条“支付成功”消息,本来是为了通知用户资料服务。
- 服务资格登记程序也收到了这条消息,并按自己的处理逻辑再登记一份服务。
- 同一笔订单下就有了两份服务记录。
第一份由换品流程创建,第二份由接收消息的另一段程序创建。 这里重复的是服务资格记录,不是订单本身。
给一个服务补通知时,复用了另一个程序也会处理的消息,结果让已完成的登记又做了一遍。
修复时增加一种专用通知,只让用户资料服务接收,保留换品流程原本的服务登记,不再触发另一段登记程序。这个修复已经发布,重复的服务记录也已清理。
错误代码
void finishReplacement(Order order) {
rightService.create(order.getId()); // 换品流程已登记第一份服务
// 为了让用户资料服务收到通知,复用“支付成功”消息。
eventBus.publish(new PaymentSucceededEvent(order.getId()));
}
// 另一个程序也接收这种消息,导致再登记一份服务。
void onPaymentSucceeded(PaymentSucceededEvent event) {
rightService.create(event.orderId());
}
修复代码示例
void finishReplacement(Order order) {
rightService.create(order.getId()); // 保留原来的服务登记
// 换成专用通知,不再触发“支付成功”的服务登记程序。
eventBus.publish(new ProfileNoticeEvent(order.getId()));
}
// 这类通知只由用户资料服务接收。
void onProfileNotice(ProfileNoticeEvent event) {
profileService.handleOrderNotice(event.orderId());
}
finishReplacement 是换品处理方法;rightService.create 表示登记用户可使用的服务。事件发送后,由接收该类型消息的程序分别处理。修复的关键是更换通知类型和接收范围,让通知用户资料服务这件事不再触发第二次服务登记。
下次遇到这些场景要警惕
- 要让某个服务收到消息:先列出这条消息的全部接收程序,以及它们各自会做什么,不能只看目标服务有没有收到。
- 原流程已经做过创建或扣减:增加消息发送后,把整条流程再跑一遍,确认最终仍只有一份应有的结果。
- 复用“支付成功、订单完成”等已有消息:检查已有接收程序会不会再建记录、扣库存或修改状态;只验证消息发成功不够。