架构与系统设计 / 系统课时

用 Outbox 保证订单事件一致

用 Outbox 保证订单事件一致

订单落库和消息发送分属两个系统,任何“先写库再发消息”或“先发消息再写库”的方案都有失败窗口。Outbox 的做法是把业务变更与待发布事件写进同一个本地事务,再让独立发布器可靠地把事件送入消息系统。

学习目标

  • 用本地事务消除“订单成功、事件丢失”的双写窗口
  • 设计可重试、可抢占的 Outbox 发布流程
  • 明确重复投递、补发和事件清理的处理边界

双写为什么会失去一致性

假设支付完成后需要把订单改为 PAID,并发布 OrderPaid 事件。若先提交数据库再发消息,数据库提交后进程崩溃,订单已经支付但下游永远收不到事件;若先发消息再提交数据库,则数据库失败时,下游可能已经处理了一个实际上没有生效的订单状态。

Outbox 不尝试让数据库与消息队列参加同一个分布式事务,而是把“业务事实”和“需要发送的事件”一起持久化。只要本地事务成功,两者就同时存在;消息发送失败只会让事件暂时滞留,不会把事件永久丢掉。

Outbox 从订单事务到消息发布的数据流

在一个事务里写订单和事件

下面用 MySQL 演示最小可运行方案。订单状态更新和 Outbox 插入只有一次 COMMIT,因此不存在其中一个成功、另一个失败后仍被提交的状态。

sql
DROP TABLE IF EXISTS outbox_event;
DROP TABLE IF EXISTS orders;

CREATE TABLE orders (
  order_id BIGINT PRIMARY KEY,
  status VARCHAR(20) NOT NULL
) ENGINE=InnoDB;

CREATE TABLE outbox_event (
  event_id VARCHAR(36) PRIMARY KEY,
  aggregate_id BIGINT NOT NULL,
  event_type VARCHAR(50) NOT NULL,
  payload JSON NOT NULL,
  publish_status VARCHAR(20) NOT NULL DEFAULT 'NEW',
  retry_count INT NOT NULL DEFAULT 0
) ENGINE=InnoDB;

INSERT INTO orders(order_id, status) VALUES (1001, 'PENDING');

START TRANSACTION;

UPDATE orders
SET status = 'PAID'
WHERE order_id = 1001 AND status = 'PENDING';

INSERT INTO outbox_event(
  event_id, aggregate_id, event_type, payload
) VALUES (
  'evt-1001-paid',
  1001,
  'OrderPaid',
  JSON_OBJECT('orderId', 1001, 'status', 'PAID')
);

COMMIT;

SELECT order_id, status FROM orders WHERE order_id = 1001;
SELECT event_id, event_type, publish_status, retry_count
FROM outbox_event
WHERE event_id = 'evt-1001-paid';

预期输出

text
+----------+--------+
| order_id | status |
+----------+--------+
|     1001 | PAID   |
+----------+--------+

+---------------+------------+----------------+-------------+
| event_id      | event_type | publish_status | retry_count |
+---------------+------------+----------------+-------------+
| evt-1001-paid | OrderPaid  | NEW            |           0 |
+---------------+------------+----------------+-------------+

这里真正需要保证的是:业务代码只有在订单状态成功变更后才插入对应事件。实际服务还应检查 UPDATE 的受影响行数;若订单已经是 PAID、CANCELLED 等其他状态,就不应再次创建新的支付事件。

让发布器可以失败后继续工作

Outbox 表只是把事件可靠地保存下来,真正的消息发布由独立 Publisher 完成。一个常见循环是:读取待发送事件、抢占一批记录、发送到 Broker、成功后标记 SENT,失败则增加重试次数并等待下一轮。

多实例 Publisher 不能无条件同时扫描同一批 NEW 记录,否则会产生大量无意义的重复发送。可以使用数据库行锁配合 SKIP LOCKED,或增加 SENDING、租约截止时间和发布者标识,让同一时刻只有一个实例负责某条记录;实例崩溃后,租约过期的事件重新进入补发队列。

接受至少一次投递并做好幂等

即使 Outbox 自身没有丢事件,也很难靠“发送成功后再更新数据库”得到严格一次投递。典型情况是 Broker 已经确认消息,但 Publisher 在更新 SENT 前崩溃;恢复后它会再次发送同一个事件。

因此工程上通常采用至少一次投递 + 消费端幂等。event_id 应在事件创建时确定,并在所有重试中保持不变。消费者可以建立已处理事件表,以 event_id 唯一约束去重;对于天然幂等的状态覆盖操作,也应保留事件 ID 以便审计和排查。

补发策略还需要设置退避和告警。短暂网络故障可以自动重试,连续失败超过阈值后进入人工关注范围,但不应直接删除记录。retry_count、最近错误和下次重试时间都是有价值的可观测字段。

清理不能破坏补发能力

已成功发布的 SENT 事件不必永久留在主表,但清理必须晚于业务允许的最大追溯窗口。常见做法是定时归档或按创建时间批量删除已经确认发布的老记录,而 NEW、SENDING 或失败中的事件绝不能按年龄直接清掉。

Outbox 解决的是“本地数据库状态与待发布事件同时落地”这一关键一致性问题,而不是把整个链路变成严格一次执行。可靠方案的完整闭环是:本地事务保证不丢事件,Publisher 持续补发,稳定的 event_id 支撑消费幂等,监控与归档负责长期运行。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Outbox 保证订单事件一致

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通