消息队列 / 系统课时
NACK 和超时后应该怎么处理
NACK 和超时后应该怎么处理
Publisher Confirm 失败后,最危险的做法是把所有异常都当成“消息没发出去”。本课区分明确 NACK 与确认结果未知两类情况,并把重试、持久记录和人工补偿组织成一条可收敛的处理链。
学习目标
- 区分 NACK、确认超时和连接中断所代表的不同确定性
- 设计带次数上限、退避和稳定消息 ID 的重试策略
- 在自动重试无法收敛时保留可追踪记录,进入人工补偿
先区分两类失败
Publisher Confirm 只回答“Broker 是否确认了这次发布”,它不是消费者处理结果。生产者收到明确 NACK 时,可以确定 Broker 对这次发布给出了否定确认;这种情况通常与 Broker 内部无法完成消息处理有关,而不是“路由不到队列”。若要发现不可路由消息,还需要结合 mandatory 和 return callback。
超时、连接断开或进程在收到确认前崩溃则不同:生产者只知道“没有拿到最终确认”,却不能据此断言消息未进入 Broker。消息可能已经成功入队,只是 ACK 没有回到生产者;此时直接重发可能制造重复消息。

用有限重试让失败收敛
重试必须有上限。建议把每次业务消息分配一个稳定 messageId,后续重试沿用同一个 ID;消费者再用业务唯一键或消息 ID 做幂等。重试次数、间隔和最终状态应写入数据库、Outbox 或其他持久介质,避免生产者进程重启后丢失待补偿任务。
对 NACK 可以按短暂故障处理并有限重试。对超时或连接中断则要按“未知结果”处理:允许重试,但必须接受重复可能性,不能把它描述成确定失败。连续失败达到上限后,应停止自动重试,转入告警和人工处置,避免在 Broker 故障期间形成无限重试风暴。
最小处理示例
下面是片段示例:假设项目已经引入 RabbitMQ Java Client,且本机 RabbitMQ 可用。每次尝试都创建新的 Channel,避免一次超时后旧的未确认序号继续影响下一次判断;所有尝试复用同一个 messageId。
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,实际值会不同。
CONFIRMED messageId=<ID> attempt=1若连续三次都未能确认,程序会把最终状态追加到 publisher-failures.log,并输出:
RECORDED_FOR_MANUAL_COMPENSATION补偿记录至少要能回答什么
人工补偿不是“再点一次发送”这么简单。记录中至少要有稳定消息 ID、业务键、消息内容或可重建消息的引用、首次发布时间、重试次数、最后一次失败类型和最后错误信息。补偿人员据此判断消息是否已经生效、是否允许再次发布,以及下游是否具备幂等能力。
真正稳妥的生产方案通常会把“待发布消息”先持久化,再由独立发布器发送并更新确认状态。这样即使应用进程在发布或收 ACK 的瞬间崩溃,也能从持久记录恢复,而不是依赖内存中的重试循环。