消息队列 / 系统课时
确认与拒绝消息
确认与拒绝消息
手动确认模式不仅能告诉 RabbitMQ“这条消息处理成功”,还可以明确表示失败、批量处理失败以及是否重新入队。掌握 ack、nack 和 reject 的差异,才能避免消息误删、无限重投或批量确认越界。
学习目标
- 区分
ack、nack与reject的作用和参数 - 能正确选择重新入队或丢弃消息
- 理解批量确认与批量拒绝的作用范围
三种操作分别做什么
ack 表示消息处理完成;nack 表示处理失败,并可一次作用于多条未确认消息;reject 只拒绝单条消息。nack 和 reject 都可以通过 requeue 决定消息是重新进入队列,还是被丢弃或进入死信流程。
| 操作 | 是否支持批量 | 是否支持重新入队 | 典型用途 |
|---|---|---|---|
ack |
支持 | 不适用 | 处理成功后完成消息 |
nack |
支持 | 支持 | 单条或批量失败,需要重试或丢弃 |
reject |
不支持 | 支持 | 明确拒绝当前这一条消息 |
当 requeue=false 时,如果队列配置了 Dead Letter Exchange,消息会按死信规则路由;没有死信配置时,消息通常会被丢弃。
按失败类型决定消息去向
处理成功时发送 ack。临时故障,例如短暂网络失败或下游服务过载,可以使用 nack 或 reject 并设置 requeue=true。确定无法恢复的数据错误,则应设置 requeue=false,让消息进入死信流程或被丢弃。

用代码控制完成与拒绝
下面示例把消息体分成三类:ok 表示成功,retry 表示临时失败,其他内容视为不可恢复错误。示例使用手动确认,因此每个分支都必须明确结束消息状态。
import pika
connection = pika.BlockingConnection(
pika.ConnectionParameters(host="localhost")
)
channel = connection.channel()
channel.queue_declare(queue="decision-demo", durable=True)
def handle_message(ch, method, properties, body):
text = body.decode()
tag = method.delivery_tag
print(f"received tag={tag} body={text}")
if text == "ok":
ch.basic_ack(delivery_tag=tag)
print("ack")
return
if text == "retry":
# 临时失败:重新入队,后续仍可能再次投递。
ch.basic_nack(
delivery_tag=tag,
multiple=False,
requeue=True,
)
print("nack requeue=true")
return
# 不可恢复错误:拒绝当前单条消息,不重新入队。
ch.basic_reject(
delivery_tag=tag,
requeue=False,
)
print("reject requeue=false")
channel.basic_consume(
queue="decision-demo",
on_message_callback=handle_message,
auto_ack=False,
)
print("waiting for messages")
channel.start_consuming()预期输出(依次投递 ok、retry 和 bad-data 时,实际 delivery tag 可能不同):
waiting for messages
received tag=<ID> body=ok
ack
received tag=<ID> body=retry
nack requeue=true
received tag=<ID> body=bad-data
reject requeue=falseretry 会重新进入可投递状态,因此它可能很快再次出现;这也是实际系统必须限制重试次数的原因。
批量确认与批量拒绝的边界
RabbitMQ 的 delivery tag 在 Channel 内单调递增并且只对当前 Channel 有效。当 basic_ack 或 basic_nack 使用 multiple=true 时,会作用于当前 Channel 上 delivery tag 小于等于目标值的所有未确认消息。
例如当前未确认的 delivery tag 为 10、11、12,对 12 执行 basic_nack(..., multiple=True, requeue=False),三条消息都会一起被拒绝。这个能力适合按顺序成批处理,但如果前面的消息尚未真正完成,就可能误确认或误拒绝。
basic_reject 没有 multiple 参数,因此只处理当前指定的一条消息。批量操作前应明确未确认集合的边界,并避免多个线程随意共享同一个 Channel,否则 delivery tag 与处理顺序很容易被打乱。
最终原则很简单:成功才 ack;可恢复失败要有受控重试;不可恢复失败应离开主队列。批量操作只在消息处理顺序和确认边界都可证明正确时使用。