Java 后端 / 系统课时
设计事务与消息一致性
设计事务与消息一致性
数据库事务和消息发送通常由两个不同系统负责,数据库的 commit 并不能天然把消息发送一起锁进原子操作。要解决“数据库成功但消息没发”或“消息发出但数据库回滚”,需要把业务事实先可靠落库,再由独立投递链路把它变成消息。
学习目标
- 理解数据库事务与消息发送之间为什么存在原子性边界。
- 掌握 Outbox 的核心数据流和最小实现方式。
- 能识别 Outbox 的重复投递、积压和幂等边界。
两阶段写入为什么会出现空档
假设创建订单时要同时写数据库并发送 OrderCreated 消息。先写数据库再发消息,数据库提交成功后应用可能宕机,消息因此永远没有发出;先发消息再提交数据库,则数据库回滚后,下游可能已经消费了一条并不存在的订单事件。
这个问题的本质不是“事务注解没写对”,而是数据库资源和消息系统没有共同的本地事务边界。把发送消息放进 @Transactional 方法,也不能自动让消息代理和数据库共享一个原子提交。

用 Outbox 把消息事实先落库
Outbox 的核心做法是:业务数据和一条待发送事件记录在同一个数据库事务中提交。事务一旦成功,至少可以确认“业务事实”和“待发送事实”同时存在;之后由独立的投递程序不断扫描 Outbox,将事件发送到消息系统。
最小表结构可以这样设计:
CREATE TABLE outbox_event (
id BIGINT PRIMARY KEY,
aggregate_type VARCHAR(64) NOT NULL,
aggregate_id BIGINT NOT NULL,
event_type VARCHAR(128) NOT NULL,
payload JSON NOT NULL,
published_at TIMESTAMP NULL,
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
);
INSERT INTO orders(id, status)
VALUES (<ID>, 'CREATED');
INSERT INTO outbox_event(
id, aggregate_type, aggregate_id, event_type, payload
)
VALUES (
<ID>, 'Order', <ID>, 'OrderCreated',
JSON_OBJECT('orderId', <ID>, 'status', 'CREATED')
);预期结果
orders 中存在 orderId=<ID> 的订单记录。
outbox_event 中存在同一 orderId=<ID> 的 OrderCreated 事件。
两条 INSERT 在同一个事务中提交;事务回滚时,两者都不存在。实际应用中,这两条写入应位于同一个 @Transactional 方法。outbox_event 是本地数据库事实的一部分,而不是“发送消息的备注表”;它必须能够独立支撑后续补发、重试和审计。
设计投递与重复消费
Outbox Relay 可以按固定间隔轮询未发送记录,也可以通过更高效的事件捕获机制读取新增记录。无论采用哪种方式,都不要假设“读取 Outbox → 发布消息 → 标记已发送”能天然做到 exactly-once。
例如消息已经成功发布,但应用在更新 published_at 前崩溃,重启后同一事件仍会被再次发送。因此工程上通常接受 at-least-once 投递,再要求消费者按事件 ID、业务唯一键或幂等表去重。
对于消费者,可以把“处理事件”和“记录已处理标记”放进同一个本地事务:同一个事件第二次到达时,发现幂等键已经存在,就跳过实际副作用。这样重复消息不会重复扣库存、重复记账或重复创建资源。
Outbox 的边界与治理重点
Outbox 解决的是“业务数据库事实与待发送事实不能分裂”的问题,并不能自动解决所有消息系统问题。事件积压、投递失败、消费者宕机、消息顺序、跨区域复制和下游幂等,仍然需要单独治理。
还要控制 Outbox 表的生命周期。高吞吐系统会持续产生事件,如果长期不归档,扫描范围和存储体积都会增长。常见做法是保留必要审计窗口后归档或删除已完成记录,同时保留足够的失败记录和重试信息用于排障。
选择方案的判断边界
如果只是当前应用内、丢一次影响很小的附加动作,@TransactionalEventListener(AFTER_COMMIT) 往往已经足够;如果要求数据库提交后消息最终必须可恢复、可重试,则应考虑 Outbox。
真正做工程设计时,可以先问一个问题:事务提交成功后,即使应用立即崩溃,这个事件是否必须在恢复后仍然存在并能够继续投递? 如果答案是“必须”,就需要把事件本身变成持久化事实,而不是只存在于内存回调里。