消息队列 / 系统课时

NACK 和超时后应该怎么处理

NACK 和超时后应该怎么处理

Publisher Confirm 失败后,最危险的做法是把所有异常都当成“消息没发出去”。本课区分明确 NACK 与确认结果未知两类情况,并把重试、持久记录和人工补偿组织成一条可收敛的处理链。

学习目标

  • 区分 NACK、确认超时和连接中断所代表的不同确定性
  • 设计带次数上限、退避和稳定消息 ID 的重试策略
  • 在自动重试无法收敛时保留可追踪记录,进入人工补偿

先区分两类失败

Publisher Confirm 只回答“Broker 是否确认了这次发布”,它不是消费者处理结果。生产者收到明确 NACK 时,可以确定 Broker 对这次发布给出了否定确认;这种情况通常与 Broker 内部无法完成消息处理有关,而不是“路由不到队列”。若要发现不可路由消息,还需要结合 mandatory 和 return callback。

超时、连接断开或进程在收到确认前崩溃则不同:生产者只知道“没有拿到最终确认”,却不能据此断言消息未进入 Broker。消息可能已经成功入队,只是 ACK 没有回到生产者;此时直接重发可能制造重复消息。

NACK 与确认结果未知的处理分支

用有限重试让失败收敛

重试必须有上限。建议把每次业务消息分配一个稳定 messageId,后续重试沿用同一个 ID;消费者再用业务唯一键或消息 ID 做幂等。重试次数、间隔和最终状态应写入数据库、Outbox 或其他持久介质,避免生产者进程重启后丢失待补偿任务。

对 NACK 可以按短暂故障处理并有限重试。对超时或连接中断则要按“未知结果”处理:允许重试,但必须接受重复可能性,不能把它描述成确定失败。连续失败达到上限后,应停止自动重试,转入告警和人工处置,避免在 Broker 故障期间形成无限重试风暴。

最小处理示例

下面是片段示例:假设项目已经引入 RabbitMQ Java Client,且本机 RabbitMQ 可用。每次尝试都创建新的 Channel,避免一次超时后旧的未确认序号继续影响下一次判断;所有尝试复用同一个 messageId。

java
import com.rabbitmq.client.AMQP;
import com.rabbitmq.client.BuiltinExchangeType;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;

import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.StandardOpenOption;
import java.util.UUID;
import java.util.concurrent.TimeoutException;

public class ConfirmRetryDemo {
    private static final int MAX_ATTEMPTS = 3;

    public static void main(String[] args) throws Exception {
        ConnectionFactory factory = new ConnectionFactory();
        factory.setHost("localhost");

        String messageId = UUID.randomUUID().toString();
        String body = "order.created";
        String lastState = "UNKNOWN";

        try (Connection connection = factory.newConnection()) {
            for (int attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
                try (Channel channel = connection.createChannel()) {
                    channel.exchangeDeclare("orders", BuiltinExchangeType.DIRECT, true);
                    channel.queueDeclare("orders.q", true, false, false, null);
                    channel.queueBind("orders.q", "orders", "created");
                    channel.confirmSelect();

                    AMQP.BasicProperties props = new AMQP.BasicProperties.Builder()
                            .deliveryMode(2)
                            .messageId(messageId)
                            .contentType("text/plain")
                            .build();

                    channel.basicPublish(
                            "orders",
                            "created",
                            props,
                            body.getBytes(StandardCharsets.UTF_8)
                    );

                    try {
                        // 当前 Channel 只有这一条待确认消息,false 就是明确 NACK。
                        if (channel.waitForConfirms(3000)) {
                            System.out.printf(
                                    "CONFIRMED messageId=%s attempt=%d%n",
                                    messageId,
                                    attempt
                            );
                            return;
                        }

                        lastState = "NACK";
                        System.out.printf("NACK attempt=%d%n", attempt);
                    } catch (TimeoutException e) {
                        // 超时只代表未及时拿到确认,消息是否已入队仍未知。
                        lastState = "TIMEOUT_UNKNOWN";
                        System.out.printf("TIMEOUT attempt=%d%n", attempt);
                    }
                }

                Thread.sleep(200L * attempt);
            }
        }

        String record = String.format(
                "messageId=%s state=%s%n",
                messageId,
                lastState
        );
        Files.writeString(
                Path.of("publisher-failures.log"),
                record,
                StandardOpenOption.CREATE,
                StandardOpenOption.APPEND
        );
        System.out.println("RECORDED_FOR_MANUAL_COMPENSATION");
    }
}

正常链路的预期输出如下,<ID> 为运行时生成的消息 ID,实际值会不同。

text
CONFIRMED messageId=<ID> attempt=1

若连续三次都未能确认,程序会把最终状态追加到 publisher-failures.log,并输出:

text
RECORDED_FOR_MANUAL_COMPENSATION

补偿记录至少要能回答什么

人工补偿不是“再点一次发送”这么简单。记录中至少要有稳定消息 ID、业务键、消息内容或可重建消息的引用、首次发布时间、重试次数、最后一次失败类型和最后错误信息。补偿人员据此判断消息是否已经生效、是否允许再次发布,以及下游是否具备幂等能力。

真正稳妥的生产方案通常会把“待发布消息”先持久化,再由独立发布器发送并更新确认状态。这样即使应用进程在发布或收 ACK 的瞬间崩溃,也能从持久记录恢复,而不是依赖内存中的重试循环。

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

目录与阅读设置

阅读设置

17

记录一个想法

NACK 和超时后应该怎么处理

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

登录哪都通