消息队列 / 系统课时
幂等消费
幂等消费
RabbitMQ 的可靠消费通常采用手动确认,因此同一条业务消息可能再次送达。本篇用业务唯一键、数据库唯一约束和状态机把“重复收到”转化为“只生效一次”,并明确数据库提交与 ACK 的正确顺序。
学习目标
- 解释为什么可靠投递仍可能产生重复消费
- 用业务唯一键和去重记录阻止同一事件重复执行
- 用状态机约束业务状态,并正确安排事务提交与 ACK
重复投递发生在哪里
手动 ACK 解决的是“消息处理失败后还能再投”,不是“消息永远只出现一次”。典型窗口是:消费者已经完成数据库更新,但 ACK 尚未到达 Broker,连接就中断。RabbitMQ 无法确认业务是否完成,只能把未确认消息重新投递,因此消费者必须允许同一事件再次到达。
deliveryTag 只在当前 Channel 内用于确认投递,不能作为跨重连的业务去重键;redelivered 也只是重投提示。真正稳定的幂等键应来自业务事件本身,例如支付事件的 payment_event_id、订单事件的 order_id + event_type + version。

选择能跨重投保持稳定的幂等键
幂等键首先要回答“哪两次执行在业务上算同一件事”。不要使用消费者收到消息的时间、随机 UUID 或 Channel 内的投递序号,因为重投后这些值可能变化。生产者应在第一次创建业务事件时生成稳定 event_id,后续重发必须沿用它。
只用 order_id 也可能过粗:同一订单可能先后发生“已支付”“已发货”等多个合法事件。此时应把事件类型或业务版本纳入键中,使去重粒度与实际副作用一致。
用唯一约束把去重和业务更新放进同一事务
下面用 MySQL 演示核心做法。去重表的主键保证同一消费者对同一事件只能登记一次;订单更新带状态条件,避免重复或越序地改变业务状态。两次执行完全相同的“支付完成”事件后,业务状态仍只更新一次。
CREATE DATABASE IF NOT EXISTS rabbitmq_demo;
USE rabbitmq_demo;
DROP TABLE IF EXISTS consumed_message;
DROP TABLE IF EXISTS orders;
CREATE TABLE orders (
id BIGINT PRIMARY KEY,
status VARCHAR(32) NOT NULL,
paid_event_id VARCHAR(64)
) ENGINE = InnoDB;
CREATE TABLE consumed_message (
consumer_name VARCHAR(64) NOT NULL,
event_id VARCHAR(64) NOT NULL,
processed_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (consumer_name, event_id)
) ENGINE = InnoDB;
INSERT INTO orders (id, status) VALUES (1001, 'CREATED');
-- 第一次投递:登记幂等键,并只允许 CREATED -> PAID。
START TRANSACTION;
INSERT IGNORE INTO consumed_message (consumer_name, event_id)
VALUES ('order-service', 'evt-payment-1001');
SET @first_delivery := ROW_COUNT();
UPDATE orders
SET status = 'PAID', paid_event_id = 'evt-payment-1001'
WHERE id = 1001
AND status = 'CREATED'
AND @first_delivery = 1;
COMMIT;
-- 模拟同一消息再次投递:唯一键已存在,不再触发业务更新。
START TRANSACTION;
INSERT IGNORE INTO consumed_message (consumer_name, event_id)
VALUES ('order-service', 'evt-payment-1001');
SET @second_delivery := ROW_COUNT();
UPDATE orders
SET status = 'PAID', paid_event_id = 'evt-payment-1001'
WHERE id = 1001
AND status = 'CREATED'
AND @second_delivery = 1;
COMMIT;
SELECT id, status, paid_event_id FROM orders WHERE id = 1001;
SELECT COUNT(*) AS dedup_rows
FROM consumed_message
WHERE consumer_name = 'order-service'
AND event_id = 'evt-payment-1001';预期结果
id status paid_event_id
1001 PAID evt-payment-1001
dedup_rows
1真实消费者应在数据库事务提交成功后再发送 basicAck。如果事务失败,应回滚并让消息进入重试路径;如果明确识别到幂等键已存在,则可以跳过业务副作用并 ACK。示例中的 INSERT IGNORE 便于展示结果,生产代码更适合只捕获“唯一键冲突”,不要把其他数据错误一起忽略。
状态机负责处理“不是同一条”的重复效果
唯一键只能阻止“同一个事件”执行两次,状态机则限制“不同事件是否允许在当前状态生效”。例如订单只有 CREATED -> PAID 才允许支付完成;后到的旧事件、逆序事件或非法跳转都应被拒绝,而不是因为事件 ID 不同就直接执行。
如果业务副作用还包括发邮件、调用第三方支付或写另一个数据库,单个本地事务无法同时覆盖这些系统。此时应继续把 event_id 作为下游幂等键,或使用 Outbox 等模式可靠地驱动外部副作用。可靠消息的目标不是假设“绝不重复”,而是让重复发生时业务结果仍然正确。