消息队列 / 系统课时
项目需求与事件流程
项目需求与事件流程
订单事件平台首先要解决的不是“把消息发出去”,而是把业务边界、事件顺序和失败后的补偿动作说清楚。本节用一个最小可落地流程串起订单、库存、支付和通知服务,并把至少一次投递、幂等与补偿要求转成可验收规则。
学习目标
- 划分订单、库存、支付和通知服务的职责边界。
- 画清主事件链路,并识别失败分支与补偿动作。
- 为跨服务消息确定投递语义、幂等键和验收条件。
划清服务边界
订单服务负责订单状态,不直接修改库存、扣款或发送短信;库存服务只决定是否能预留或释放库存;支付服务只管理支付与退款;通知服务根据最终业务事件发送消息。边界越清楚,失败时越容易判断“谁拥有状态、谁负责补偿”。
| 服务 | 核心状态 | 主要输入 | 主要输出 |
|---|---|---|---|
| 订单服务 | PENDING、CONFIRMED、CANCELLED |
下单请求、库存与支付结果 | OrderCreated、OrderConfirmed、OrderCancelled |
| 库存服务 | 可售量、预留量 | OrderCreated、释放请求 |
InventoryReserved、InventoryRejected、InventoryReleased |
| 支付服务 | 待支付、成功、失败、退款 | InventoryReserved、退款请求 |
PaymentSucceeded、PaymentFailed、PaymentRefunded |
| 通知服务 | 通知任务状态 | 订单最终事件 | 发送结果或重试记录 |
串起主事件链路
正常路径采用事件驱动的 Saga 编排思路:订单创建后先预留库存,库存成功再发起支付,支付成功后订单确认并触发通知。这样支付失败时只需释放已预留库存;库存不足则在扣款前直接取消订单。

事件本身要携带可去重、可追踪的最小公共字段。下面是 OrderCreated 的事件信封;<ID> 与 <TIME> 是动态值,实际运行时会替换成真实事件 ID、订单 ID 和时间。
{
"eventId": "<ID>",
"eventType": "OrderCreated",
"schemaVersion": 1,
"occurredAt": "<TIME>",
"aggregateId": "<ID>",
"payload": {
"customerId": "<ID>",
"totalAmount": 199.00
}
}该结构不是可执行程序,而是跨服务契约。消费者应使用 eventId 做幂等去重,使用 aggregateId 关联同一订单,并把业务字段放在 payload 中,避免每个事件重复定义追踪字段。
明确投递语义
本项目把服务间交付基线定为“至少一次”,即消息可能重复,但不能因为短暂故障静默丢失。Kafka 的消费者重试会让同一事件再次到达,因此“处理一次”的责任必须落到业务侧幂等,而不是假设消费者永远只收到一次。
订单写库和发布 OrderCreated 之间还存在双写窗口。生产实现应使用事务 Outbox 或等价机制,让“本地状态变更”和“待发布事件记录”处在同一本地事务中,再异步投递到 Kafka。这样数据库已经提交但进程突然退出时,事件仍可恢复发布。
把失败变成可验收规则
失败处理不要只写“重试”。库存不足属于业务拒绝,应立即产生 InventoryRejected;支付超时可先重试,超过阈值后产生 PaymentFailed;支付失败后必须请求释放库存;通知失败不应回滚已完成订单,而应独立重试或进入死信处理。
验收时至少检查三类场景:正常订单最终进入 CONFIRMED;库存不足不会触发支付;支付失败最终进入 CANCELLED 且库存被释放。再主动重复投递同一个 eventId,确认库存、扣款和订单状态都不会被重复执行,才算满足事件平台的最小可靠性要求。