消息队列 / 系统课时

确认与拒绝消息

确认与拒绝消息

手动确认模式不仅能告诉 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,让消息进入死信流程或被丢弃。

ack、nack 与 reject 的处理决策

用代码控制完成与拒绝

下面示例把消息体分成三类:ok 表示成功,retry 表示临时失败,其他内容视为不可恢复错误。示例使用手动确认,因此每个分支都必须明确结束消息状态。

python
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 可能不同):

text
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=false

retry 会重新进入可投递状态,因此它可能很快再次出现;这也是实际系统必须限制重试次数的原因。

批量确认与批量拒绝的边界

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;可恢复失败要有受控重试;不可恢复失败应离开主队列。批量操作只在消息处理顺序和确认边界都可证明正确时使用。

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

目录与阅读设置

阅读设置

17

记录一个想法

确认与拒绝消息

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

登录哪都通