消息队列 / 系统课时
发送确认与返回回调
发送确认与返回回调
发送接口正常返回,并不代表消息一定进入了目标队列。Spring Boot 可以同时接收 Publisher Confirm 与 Publisher Return:前者判断 Broker 是否确认发布,后者识别消息是否因为没有匹配路由而被退回。本课把两条反馈链路同时接好,并验证成功与不可路由两种结果。
学习目标
- 开启 correlated Publisher Confirm、Publisher Return 与
mandatory - 使用
ConfirmCallback和ReturnsCallback区分发布确认与路由失败 - 用
CorrelationData把异步确认结果关联回具体业务消息
先分清两种反馈
Confirm 与 Return 回答的是两个不同问题。Confirm 关注 Broker 是否对本次发布负责,回调中的 ack=true 表示发布获得确认;Return 关注消息从 Exchange 路由到 Queue 时是否失败,只有开启 mandatory 后,不可路由消息才会返回给发布者。
因此,“收到 Confirm ACK”不能单独证明消息已经进入目标队列。典型的无匹配路由场景中,消息可以先触发 Return,同时仍收到 Confirm ACK,因为 Exchange 已经接收并处理了这次发布,只是没有找到可投递的队列。

开启确认与返回
Spring Boot 中可以通过 RabbitMQ 配置直接开启这三项能力:
spring:
rabbitmq:
publisher-confirm-type: correlated
publisher-returns: true
template:
mandatory: truepublisher-confirm-type: correlated 让每次发布可以通过 CorrelationData 对应到异步确认;publisher-returns: true 打开返回机制;mandatory: true 要求 Broker 在无法路由消息时把消息退回发布者,而不是静默丢弃。
配置生效后的验证方法是:发送一条能正常路由的消息,应收到 Confirm;再发送一条 Exchange 存在但 routing key 无匹配绑定的消息,应额外收到 Return。
注册两个回调
每个 RabbitTemplate 分别注册一个确认回调和一个返回回调。确认回调读取业务关联 ID、ack 与失败原因;返回回调读取被退回的消息、回复码、回复文本、Exchange 和 routing key。
package com.example.rabbitmq;
import jakarta.annotation.PostConstruct;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.stereotype.Component;
@Component
public class PublishCallbackConfigurer {
private final RabbitTemplate rabbitTemplate;
public PublishCallbackConfigurer(RabbitTemplate rabbitTemplate) {
this.rabbitTemplate = rabbitTemplate;
}
@PostConstruct
public void configure() {
rabbitTemplate.setConfirmCallback((correlationData, ack, cause) -> {
String id = correlationData == null
? "<ID>"
: correlationData.getId();
System.out.printf(
"confirm id=%s ack=%s cause=%s%n",
id, ack, cause);
});
rabbitTemplate.setReturnsCallback(returned -> {
System.out.printf(
"return code=%d text=%s exchange=%s routingKey=%s%n",
returned.getReplyCode(),
returned.getReplyText(),
returned.getExchange(),
returned.getRoutingKey());
});
}
}这段组件会在应用启动时为 Boot 创建的 RabbitTemplate 注册回调。生产代码不要在每次发送前重复覆盖回调,否则不同业务模块可能互相抢占同一个模板的回调设置。
用关联 ID 验证两种结果
发送时给 CorrelationData 一个唯一业务 ID。下面的服务同时提供“正常路由”和“故意不可路由”两个方法;它们都发布到已存在的 order.events Exchange。
package com.example.rabbitmq;
import org.springframework.amqp.rabbit.connection.CorrelationData;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.stereotype.Service;
@Service
public class ConfirmDemoService {
private final RabbitTemplate rabbitTemplate;
public ConfirmDemoService(RabbitTemplate rabbitTemplate) {
this.rabbitTemplate = rabbitTemplate;
}
public void sendRoutable() {
var correlation = new CorrelationData("msg-1001");
rabbitTemplate.convertAndSend(
"order.events", "order.created",
"order-1001", correlation);
}
public void sendUnroutable() {
var correlation = new CorrelationData("msg-1002");
rabbitTemplate.convertAndSend(
"order.events", "order.missing",
"order-1002", correlation);
}
}假设 order.created 已绑定到队列,调用 sendRoutable() 后预期输出类似:
confirm id=msg-1001 ack=true cause=null调用 sendUnroutable() 后,预期会看到 Return,并随后收到这次发布的确认;回调先后可能因异步调度略有差异,但不可路由信息应包含 NO_ROUTE:
return code=312 text=NO_ROUTE exchange=order.events routingKey=order.missing
confirm id=msg-1002 ack=true cause=null把回调结果变成业务状态
Confirm NACK、Return 和消费者 ACK 不能混为一谈。Confirm NACK 表示发布阶段没有获得 Broker 的正向确认;Return 表示 Exchange 存在但消息无法路由到队列;消费者 ACK 则发生在更后面的消费阶段,表示消费者对投递消息的处理结果。
生产环境中还应让 CorrelationData 使用真正唯一的消息 ID,并把 NACK 与 Return 写入可检索日志或失败表。这样出现路由键写错、绑定缺失或 Broker 发布异常时,才能从具体消息 ID 反查失败发生在哪一段。