RabbitMQ报错：Shutdown Signal channel error； protocol method

news2025/3/15 0:25:12

报错信息：

Shutdown Signal: channel error; protocol method: #method<channel.close>(reply-code=406, reply-text=PRECONDITION_FAILED - unknown delivery tag 1, class-id=60, method-id=80)

原因

默认情况下 RabbitMQ 是自动ACK（确认签收）机制，就意味着 MQ 会在消息发送完毕后，自动帮我们去ACK（确认），若是在代码中再手动确认签收，就会造成确认错误。

“PRECONDITION_FAILED - unknown delivery tag” 表明交付标签（delivery tag）不合法或已经被确认过

因此我们需要在订阅者（消费者）的方法上标识，消息手动确认签收ackMode = “MANUAL”，代码如下：

    @RabbitListener(queues = RabbitMqContants.DIRECT_QUEUE1_NAME,ackMode = "MANUAL")
    public void directConsumerA(String msg, Channel channel, Message message) throws IOException {

        try {
            // 处理消息
            log.info("=================DIRECT-队列1-消费者A 接收到消息：msg = {}", msg);
            //消息消费手动确认
            channel.basicAck(message.getMessageProperties().getDeliveryTag(), false);
        } catch (Exception e) {
            e.printStackTrace();
            // 处理异常，可能需要重新将消息放回队列
            channel.basicNack(message.getMessageProperties().getDeliveryTag(), false, true);
        }
    }

关于rabbitMQ在yml配置手动ack不生效，重复消费的问题

spring：
 rabbitmq:
    host: xxx
    port: 5672
    username: guest
    password: guest
    listener:
      direct:
        acknowledge-mode: manual # 手动ACK开启：自动确认 none ;手动确认 manual ;根据异常情况确认 auto (较麻烦，不推荐)

此处已经设置了手动答应，消费者代码是这样的：

@RabbitListener(queues = RabbitMqContants.DIRECT_QUEUE1_NAME)
    public void directConsumerA(String msg, Channel channel, Message message) throws IOException {

        try {
            // 处理消息
            log.info("=================DIRECT-队列1-消费者A 接收到消息：msg = {}", msg);
            //消息消费手动确认
            channel.basicAck(message.getMessageProperties().getDeliveryTag(), false);
        } catch (Exception e) {
            e.printStackTrace();
            // 处理异常，可能需要重新将消息放回队列
            channel.basicNack(message.getMessageProperties().getDeliveryTag(), false, true);
        }
    }

然而消费者会重复消费消息，控制台还是会打印如下异常：

Channel shutdown: channel error; protocol method: #method<channel.close>(reply-code=406, reply-text=PRECONDITION_FAILED - unknown delivery tag 1, class-id=60, method-id=80)

查找资料和测试发现，rabbitmq默认是用的SimpleRabbitListenerContainerFactory
配置文件中如果不指定监听容器类型的话，配置是不会生效的，
只要配置文件配置改成以下配置，这个问题就可以解决了。

spring：
 rabbitmq:
    host: xxx
    port: 5672
    username: guest
    password: guest
    listener:
      # 设置监听容器（Listener container）类型，如不设置，将会默认为SimpleRabbitListenerContainerFactory，且下面的direct配置不生效
      type: direct
      direct:
        acknowledge-mode: manual # 手动ACK开启：自动确认 none ;手动确认 manual ;根据异常情况确认 auto (较麻烦，不推荐)