业务事件
🎯 引言
上一阶段已经讲过服务间的异步通信,RabbitMQ 课程也介绍了消息发布、消费和确认。但是,支付服务已经把“支付成功”写进 MySQL,订单服务就一定能收到并正确处理这条事件吗? 不一定:消息可能来不及发布,已经处理过的消息也可能再次送达。
本篇沿用订单系统,集中解决两个问题:支付服务如何可靠地发布事件,以及订单服务如何避免重复处理同一事件。这两个问题分别使用 Transactional Outbox(事务发件箱)和消费者幂等处理来解决。
🧱 确认两个服务各自负责什么
支付服务负责保存支付结果,并发布 PaymentSucceeded(支付成功)事件;订单服务收到后,负责更新自己的订单状态。RabbitMQ 负责传递事件,不负责代替订单服务修改数据库。
正在加载流程图…
这里先回顾业务关系。真正容易出问题的是图中的发布和消费两个环节,接下来分别处理。
示例事件如下:
{
"eventId": "evt-9001",
"type": "PaymentSucceeded",
"version": 1,
"data": {
"orderId": "o-100",
"paymentId": "p-200"
}
}
orderId 指向订单,paymentId 指向支付记录,eventId 唯一标识这一次事件。一笔订单可以对应多条不同事件,但重发同一事件时必须沿用原 eventId,不能每次发送都生成新编号。这是后面识别重复消费的依据。
⚡ 消费者如何避免重复修改订单
假设订单服务已成功把 o-100 改为“已支付”,却在确认 RabbitMQ 消息前崩溃。消息重新投递时,订单服务还会再次收到 evt-9001。
我们希望的结果是:首次处理会更新订单;同一事件之后无论收到多少次,都不再重复执行订单业务。 这称为消费者幂等。
1. 用数据库主键识别处理过的事件
在订单服务自己的数据库中建立表:
CREATE TABLE processed_events (
event_id VARCHAR(80) PRIMARY KEY,
processed_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
);
主键保证相同 event_id 只能成功插入一次。假设订单表有一条 id = 'o-100'、状态为 pending_payment 的记录。
第一次处理时,在同一个本地事务中完成事件登记与订单更新:
START TRANSACTION;
INSERT INTO processed_events (event_id)
VALUES ('evt-9001');
UPDATE orders
SET status = 'paid'
WHERE id = 'o-100' AND status = 'pending_payment';
-- 确认上面的 UPDATE 恰好影响 1 行,才提交
COMMIT;
这段 SQL 展示事务边界,不是可以忽略检查的完整程序。如果订单不存在、支付记录与订单不匹配,或者状态不允许更新,就应当回滚并按业务规则处理,不能直接执行 COMMIT。
把两次数据库写入放在同一个事务,是因为它们必须一起成功:不能出现“事件被记为处理成功,但订单仍未更新”的情况。
2. 再次收到同一个事件时怎样处理
第二次处理 evt-9001,插入 processed_events 会触发主键冲突。消费程序确认这是相同事件的重复投递后,回滚当前事务、跳过订单更新,并正常确认这条重复消息。
正在加载流程图…
不要简单地“先 SELECT 查询是否处理过,再执行更新”:两个消费者可能同时查到不存在。唯一约束加事务才能可靠处理这种并发竞争。
eventId 也可能错误地表示同一笔支付,实际业务还需要根据 paymentId 和订单状态校验。⚠️ 支付数据库提交了,事件却没有发出
消费者幂等解决的是“事件收到多次”的问题,却解决不了“事件一次都没收到”。
如果支付服务先保存成功记录,再发送消息,就存在这样的时间间隙:
正在加载流程图…
这里的困难叫双写问题:支付服务要修改 MySQL,还要向 RabbitMQ 发布消息。两者属于不同系统,单个 MySQL 事务不能让它们一起提交。
即使使用了 RabbitMQ 发布确认,依然可能在“数据库提交成功”和“消息发出”之间崩溃。把发送顺序倒过来也不行:事件可能已经发出,支付数据库却没有提交。
🛠 Transactional Outbox:先把事件可靠地存下来
Transactional Outbox(事务发件箱)的做法是:支付服务不直接把“数据库更新成功”与“发送 RabbitMQ 消息”当作连续且必定成功的两步,而是把支付结果和待发送事件放进支付服务自己的数据库,使用同一个本地事务保存。
1. 建立 Outbox 表
在支付服务数据库中创建:
CREATE TABLE outbox_events (
id VARCHAR(80) PRIMARY KEY,
event_type VARCHAR(80) NOT NULL,
payload JSON NOT NULL,
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
published_at TIMESTAMP NULL DEFAULT NULL
);
payload 保存待发送的完整事件。published_at 为 NULL 表示尚未确认发布成功,供后台发布器查询。
2. 支付结果和事件一起提交
假设支付记录 p-200 原本是 pending。下面用 SQL 说明同一个事务中执行两次写入:
START TRANSACTION;
UPDATE payment_attempts
SET status = 'success'
WHERE id = 'p-200' AND status = 'pending';
-- 实际程序须先确认 UPDATE 影响 1 行;
-- 若为 0 行,按支付状态处理并回滚,不应继续插入成功事件。
INSERT INTO outbox_events (id, event_type, payload)
VALUES (
'evt-9001',
'PaymentSucceeded',
JSON_OBJECT(
'eventId', 'evt-9001',
'type', 'PaymentSucceeded',
'version', 1,
'data', JSON_OBJECT(
'orderId', 'o-100',
'paymentId', 'p-200'
)
)
);
COMMIT;
注意:SQL 客户端不会自动执行注释里的检查。实际 Node.js 业务代码必须读取 UPDATE 的受影响行数,仅在从待支付变为支付成功时才写入事件,并检查事务异常。重复支付回调需要复用已完成的业务结果,不应凭空生成另一条支付成功事件。
这样,支付服务崩溃时只有两种可能:
- 尚未提交事务:支付状态与待发事件都回滚。
- 已经提交事务:支付状态与待发事件都保存在数据库中,事件即使没有立即发送,也不会因为进程退出而消失。
3. 后台发布器怎样把事件发出去
另一个后台进程或定时任务负责查询尚未发布的 Outbox 记录,将它们发送到 RabbitMQ:
正在加载流程图…
这里的发布确认是 RabbitMQ Broker 对发布行为的确认,不表示订单服务已经更新完数据库。
如果发布器在消息已送达、但还没来得及更新 published_at 时崩溃,恢复后仍会再次发布同一条事件。因此发布器重试时要保留事件原来的 eventId,订单消费者才能用前面的方法识别重复消息。
| 故障发生的位置 | Outbox 的处理结果 |
|---|---|
| 支付数据库事务回滚 | 支付状态与待发事件一起回滚 |
| 数据库已提交,但支付进程崩溃 | 待发记录仍在数据库,发布器可以补发 |
| RabbitMQ 暂时不可用 | 保留待发记录,恢复后重试 |
| 消息已发布,但还没标记完成就崩溃 | 可能重复发布,由消费者幂等处理 |
最终,两端各自有明确职责:支付服务使用 Outbox 尽量避免事件漏发,订单服务使用幂等处理避免重复业务效果。这不意味着所有跨服务业务都会自动成功;下一篇将进一步处理订单、库存、支付多个本地事务如何协调和补偿。
❓ 知识问答
Q1:已经有 RabbitMQ 的消息持久化和发布确认,为什么还需要 Outbox?
消息持久化和发布确认主要处理消息向 RabbitMQ 发布及由它保存的环节。Outbox 处理的是更早的风险:数据库已提交,但应用还没成功发布消息。
Q2:Outbox 能保证事件只被消费一次吗?
不能。消息发布成功却未标记已发布时,可能再次发送;消费者确认失败时,也可能再次投递。所以需要消费者幂等。
Q3:处理重复事件时,可以直接忽略所有数据库错误吗?
不可以。只有明确判断为同一 eventId 已经成功处理,才能跳过业务操作。数据库连接错误、数据校验失败等需要分别处理。
🧪 小练习
为库存服务设计一条 InventoryReserved 事件(表示库存已预留):
- 给出
eventId、type、version和data,其中包含订单编号与库存预留编号。 - 说明库存服务修改预留记录与保存 Outbox 事件时,为什么要使用同一个本地事务。
- 假设该事件被发送两次,设计订单服务的
processed_events记录及状态更新顺序。 - 假设发布器在成功发送后、标记发布前退出,说明恢复后会发生什么,以及怎样避免重复业务效果。
验收标准: 能明确区分“支付或库存一侧的可靠发布”和“订单一侧的幂等消费”,并解释数据库提交、发布确认和消息确认各自发生在哪一步。
🎉 恭喜你完成本篇学习!现在你已经理解如何减少业务事件漏发风险,以及如何防止重复事件造成重复业务操作。
