消息队列 / 系统课时

发送确认与返回回调

发送确认与返回回调

发送接口正常返回,并不代表消息一定进入了目标队列。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 AMQP 发布确认与不可路由返回的两条反馈链路

开启确认与返回

Spring Boot 中可以通过 RabbitMQ 配置直接开启这三项能力:

yaml
spring:
  rabbitmq:
    publisher-confirm-type: correlated
    publisher-returns: true
    template:
      mandatory: true

publisher-confirm-type: correlated 让每次发布可以通过 CorrelationData 对应到异步确认;publisher-returns: true 打开返回机制;mandatory: true 要求 Broker 在无法路由消息时把消息退回发布者,而不是静默丢弃。

配置生效后的验证方法是:发送一条能正常路由的消息,应收到 Confirm;再发送一条 Exchange 存在但 routing key 无匹配绑定的消息,应额外收到 Return。

注册两个回调

每个 RabbitTemplate 分别注册一个确认回调和一个返回回调。确认回调读取业务关联 ID、ack 与失败原因;返回回调读取被退回的消息、回复码、回复文本、Exchange 和 routing key。

java
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。

java
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() 后预期输出类似:

text
confirm id=msg-1001 ack=true cause=null

调用 sendUnroutable() 后,预期会看到 Return,并随后收到这次发布的确认;回调先后可能因异步调度略有差异,但不可路由信息应包含 NO_ROUTE:

text
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 反查失败发生在哪一段。

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

目录与阅读设置

阅读设置

17

记录一个想法

发送确认与返回回调

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

登录哪都通