业务事件

学会使用 MySQL 事务与 Transactional Outbox 可靠发布业务事件,并通过消费者幂等避免重复修改订单。

🎯 引言

上一阶段已经讲过服务间的异步通信,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 是一种可靠发布设计,不是 RabbitMQ 自带的特殊消息类型。生产环境还需要防止多个发布器重复抢同一条记录、处理长时间无法发布的事件,并对积压进行监控。本篇先掌握核心事务与重试关系。

最终,两端各自有明确职责:支付服务使用 Outbox 尽量避免事件漏发,订单服务使用幂等处理避免重复业务效果。这不意味着所有跨服务业务都会自动成功;下一篇将进一步处理订单、库存、支付多个本地事务如何协调和补偿。


❓ 知识问答

Q1:已经有 RabbitMQ 的消息持久化和发布确认,为什么还需要 Outbox?

消息持久化和发布确认主要处理消息向 RabbitMQ 发布及由它保存的环节。Outbox 处理的是更早的风险:数据库已提交,但应用还没成功发布消息。

Q2:Outbox 能保证事件只被消费一次吗?

不能。消息发布成功却未标记已发布时,可能再次发送;消费者确认失败时,也可能再次投递。所以需要消费者幂等。

Q3:处理重复事件时,可以直接忽略所有数据库错误吗?

不可以。只有明确判断为同一 eventId 已经成功处理,才能跳过业务操作。数据库连接错误、数据校验失败等需要分别处理。


🧪 小练习

为库存服务设计一条 InventoryReserved 事件(表示库存已预留):

  1. 给出 eventId、type、version 和 data,其中包含订单编号与库存预留编号。
  2. 说明库存服务修改预留记录与保存 Outbox 事件时,为什么要使用同一个本地事务。
  3. 假设该事件被发送两次,设计订单服务的 processed_events 记录及状态更新顺序。
  4. 假设发布器在成功发送后、标记发布前退出,说明恢复后会发生什么,以及怎样避免重复业务效果。

验收标准: 能明确区分“支付或库存一侧的可靠发布”和“订单一侧的幂等消费”,并解释数据库提交、发布确认和消息确认各自发生在哪一步。


🎉 恭喜你完成本篇学习!现在你已经理解如何减少业务事件漏发风险,以及如何防止重复事件造成重复业务操作。