架构与系统设计 / 系统课时
用Outbox保证事务事件一致
用Outbox保证事务事件一致
业务状态已经提交,但事件发送失败;或者事件已发出,数据库事务却回滚,这两种情况都会让下游看到错误事实。Outbox 的做法是把业务数据和“待发布事件”写进同一个本地事务,再由独立发布器可靠地把事件送到消息系统。
学习目标
- 识别“数据库提交 + 消息发送”双写中的一致性裂缝
- 用同一本地事务同时持久化业务状态与 Outbox 事件
- 设计发布、重试和消费幂等,正确处理重复事件
裂缝来自两个独立提交
如果服务先提交数据库再发送消息,数据库成功而消息系统失败时,下游永远收不到事件;如果先发消息再提交数据库,则可能出现消息已被消费、业务事务最终却回滚的情况。问题不在调用顺序,而在于两个系统没有共享同一个原子提交点。

Outbox 把跨系统问题拆成两段:第一段只依赖数据库事务,保证“业务状态与事件意图”同生共死;第二段允许异步、可重试地发布消息。这样即使消息系统暂时不可用,事件仍留在数据库中等待恢复。
在同一事务里写业务与事件
下面用 PostgreSQL 创建订单表和 Outbox 表,并在一个事务中写入“订单已支付”状态与对应事件。事件载荷保存在 JSONB 中,published_at 为空表示尚未完成发布。
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';预期结果
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 的关键不是“多一张事件表”,而是把业务提交与事件产生收拢到同一个原子事务,再把不可避免的跨系统发送转化为可恢复、可重试、可去重的异步过程。