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

用Outbox保证事务事件一致

用Outbox保证事务事件一致

业务状态已经提交,但事件发送失败;或者事件已发出,数据库事务却回滚,这两种情况都会让下游看到错误事实。Outbox 的做法是把业务数据和“待发布事件”写进同一个本地事务,再由独立发布器可靠地把事件送到消息系统。

学习目标

  • 识别“数据库提交 + 消息发送”双写中的一致性裂缝
  • 用同一本地事务同时持久化业务状态与 Outbox 事件
  • 设计发布、重试和消费幂等,正确处理重复事件

裂缝来自两个独立提交

如果服务先提交数据库再发送消息,数据库成功而消息系统失败时,下游永远收不到事件;如果先发消息再提交数据库,则可能出现消息已被消费、业务事务最终却回滚的情况。问题不在调用顺序,而在于两个系统没有共享同一个原子提交点。

Outbox从本地事务到消息发布的可靠数据流

Outbox 把跨系统问题拆成两段:第一段只依赖数据库事务,保证“业务状态与事件意图”同生共死;第二段允许异步、可重试地发布消息。这样即使消息系统暂时不可用,事件仍留在数据库中等待恢复。

在同一事务里写业务与事件

下面用 PostgreSQL 创建订单表和 Outbox 表,并在一个事务中写入“订单已支付”状态与对应事件。事件载荷保存在 JSONB 中,published_at 为空表示尚未完成发布。

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

CREATE TABLE orders (
    id BIGINT PRIMARY KEY,
    status TEXT NOT NULL
);

CREATE TABLE outbox_event (
    event_id TEXT PRIMARY KEY,
    aggregate_type TEXT NOT NULL,
    aggregate_id TEXT NOT NULL,
    event_type TEXT NOT NULL,
    payload JSONB NOT NULL,
    published_at TIMESTAMPTZ
);

BEGIN;

INSERT INTO orders (id, status)
VALUES (1001, 'PAID');

INSERT INTO outbox_event (
    event_id,
    aggregate_type,
    aggregate_id,
    event_type,
    payload
)
VALUES (
    'evt-1001',
    'Order',
    '1001',
    'OrderPaid',
    '{"orderId":1001,"status":"PAID"}'::jsonb
);

COMMIT;

SELECT id, status FROM orders WHERE id = 1001;

SELECT event_id, event_type, aggregate_id, published_at
FROM outbox_event
WHERE event_id = 'evt-1001';

预期结果

text
orders:1001 | PAID
outbox_event:evt-1001 | OrderPaid | 1001 | null

如果事务在 COMMIT 前失败,两条写入会一起回滚;如果提交成功,即使消息系统随后宕机,outbox_event 仍然保留待发送记录。这就是 Outbox 真正提供的一致性保证。

发布器要接受至少一次发送

发布器通常循环执行三件事:读取未发布事件、发送到消息系统、确认成功后标记已发布。多实例发布器还需要通过行锁、租约或等价机制避免同一批记录被并发抢占;失败时保留未发布状态,稍后重试。

最容易忽略的窗口出现在“消息已成功发送,但 published_at 尚未写回”之间。发布器此时崩溃,恢复后会再次发送同一 event_id。因此 Outbox 通常提供的是至少一次发布,而不是凭空获得“恰好一次”。

消费者必须把 event_id 当成幂等键。常见做法是在消费者自己的本地事务中记录已经处理过的事件 ID,并让“去重记录 + 业务更新”一起提交;重复收到同一事件时直接跳过。消息系统是否支持事务并不能替代业务侧对重复的防护。

让事件表可长期运行

Outbox 表不能无限增长。生产实现通常需要为“未发布记录”建立适合扫描的索引,发布成功的历史数据按保留策略归档或清理,并监控最老未发布事件的年龄、积压数量和连续失败次数。

还要避免把任意数据库行变化都当成领域事件。Outbox 中应保存下游真正需要的稳定事件契约,例如 OrderPaid,而不是暴露内部表结构的整行快照。这样发布链路负责可靠传递,事件本身负责表达清晰、可演进的业务事实。

Outbox 的关键不是“多一张事件表”,而是把业务提交与事件产生收拢到同一个原子事务,再把不可避免的跨系统发送转化为可恢复、可重试、可去重的异步过程。

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

目录与阅读设置

阅读设置

17

记录一个想法

用Outbox保证事务事件一致

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

登录哪都通