使用RabbitMQ的手动接收模式：消息第二次入队Failed to declare queue

最新推荐文章于 2025-05-10 15:09:00 发布
最新推荐文章于 2025-05-10 15:09:00 发布
阅读量1.4k 收藏
点赞数
CC 4.0 BY-SA版权
分类专栏： # RabbitMQ 项目搭建问题 文章标签： rabbitmq
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/csnz123123/article/details/129972484
文章描述了一位开发者在使用RabbitMQ时遇到的问题，具体是手动接收模式下出现`Failedtodeclarequeue`错误。通过检查代码和对比配置，发现`listener.direct.acknowledge-mode`应改为`listener.simple.acknowledge-mode`，修改后问题得到解决。作者还探讨了`Simple`和`Direct`两种模式的区别，并决定暂时使用`Simple`模式。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

问题：在rabbitMQ测试使用手动接收模式时发生 Failed to declare queue错误

: 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)
: Received a frame on an unknown channel, ignoring it
: Received a frame on an unknown channel, ignoring it
: Received a frame on an unknown channel, ignoring it
: Restarting Consumer@2cd2c8fe: tags=[[amq.ctag-RQecbmbYQjunIZtW-ENloQ]], channel=Cached Rabbit Channel: AMQChannel(amqp://guest@IP:5672/,1), conn: Proxy@1b9ea3e3 Shared Rabbit Connection: SimpleConnection@42257bdd [delegate=amqp://guest@IP:5672/], acknowledgeMode=AUTO local queue size=0
: Failed to declare queue: csnz_queue
: Queue declaration failed; retries left=3

org.springframework.amqp.rabbit.listener.BlockingQueueConsumer$DeclarationException: Failed to declare queue(s):[csnz_queue]
at org.springframework.amqp.rabbit.listener.BlockingQueueConsumer.attemptPassiveDeclarations(BlockingQueueConsumer.java:710) [spring-rabbit-2.1.5.RELEASE.jar:2.1.5.RELEASE]
at org.springframework.amqp.rabbit.listener.BlockingQueueConsumer.passiveDeclarations(BlockingQueueConsumer.java:594) [spring-rabbit-2.1.5.RELEASE.jar:2.1.5.RELEASE]
at org.springframework.amqp.rabbit.listener.BlockingQueueConsumer.start(BlockingQueueConsumer.java:581) [spring-rabbit-2.1

现象：

监听器第一次重入队成功，第二次试图重入队发生错误

原因

设置的接收模式有问题

解决步骤：

1、排查问题：是什么导致了队列消息丢失？
2、检查代码
3、更改接收模式配置代码
4、重新测试
5、总结，吸取教训

一、排查问题：是什么导致了队列消息丢失？

最开始报错异常为：Channel shutdown，Failed to declare queue
但是检查了一遍逻辑代码，确认没问题，开始怀疑是不是配置的手动接收模式代码错了

二、检查代码

# 配置RabbitMQ 的基本信息 IP 端口 username pass
spring:
  rabbitmq:
    host: 
    port: 5672
    username: guest
    password: guest
    virtual-host: /
    listener:
      direct:
        acknowledge-mode: manual

明明没错啊，acknowledge-mode 就是为 manual，还是idea自动提示补全的呢！

看看别人怎么写这块的

listener.simple.acknowledge-mode = manual

不是吧，居然是 simpl.acknowledge-mode

三、更改接收模式配置代码 

# 配置RabbitMQ 的基本信息 IP 端口 username pass
spring:
  rabbitmq:
    host: 
    port: 5672
    username: guest
    password: guest
    virtual-host: /
    listener:
      simple:
        acknowledge-mode: manual

四、重新测试

还真tm好了
在这里插入图片描述

五、总结，吸取教训

那么 listener.simple.acknowledge-mode 和 listener.direct.acknowledge-mode 究竟有什么区别呢？

搜罗到的信息：
spring.rabbitmq.listener.direct.acknowledge-mode= # 确认容器的模式
spring.rabbitmq.listener.simple.acknowledge-mode= # 确认容器的模式

目前看来 两个应该都是可以用的，只是它和交换机的类型应该有关联。

而且在debug的过程中，我也发现了导入的《spring-boot-starter-amqp》默认使用的是Simple类型

在这里插入图片描述

要使用 direct的话应该要换掉交换机的配置，目前就先用着simple吧…

RabbitMQ 错误完美解决 Failed to declare queue(s):[directQueue-One]；channel error；
馒头花卷儿
05-23 5163
这里是Consumer消费者 这是错误详情，我们先看一下 其实这里错误很明显 org.springframework.amqp.rabbit.listener.BlockingQueueConsumer$DeclarationException: Failed to declare queue(s):[directQueue-One] 这里
RabbitMQ消息追踪：排查问题的有效工具
最新发布
架构师的AI之路，分享AI应用开发架构的学习与实践。
06-19 705
本文旨在全面介绍RabbitMQ消息追踪技术，帮助读者理解消息追踪的重要性，掌握常用的追踪工具和方法，并能够在实际工作中应用这些技术来排查和解决消息队列系统中的问题。本文将首先介绍RabbitMQ和消息追踪的基本概念，然后详细讲解消息追踪的核心原理和工具，接着通过实际案例展示如何应用这些技术，最后讨论相关工具和未来发展趋势。RabbitMQ：一个开源的消息代理和队列服务器，用于在分布式系统中存储和转发消息消息追踪：记录和分析消息在队列系统中的流转过程的技术生产者(Producer)
RabbitMQ 报错：Failed to declare queue(s):[QD, QA, QB]
weixin_45813351的博客
12-27 2384
实在没想到会犯这种低级错误。
关于Failed to declare queue(s):[xxx]报错问题
m0_47634108的博客
01-20 1万+
Failed to declare queue(s)
使用RabbitMQ时：Failed to declare queue(s):[XXX]
Ying_Lan的博客
02-06 5113
使用RabbitMQ时，遇到的问题
Failed to declare queue
走在命运的左岸
10-27 1万+
Failed to declare queue 异常信息 SEVERE: Exception sending context initialized event to listener instance of class org.springframework.web.context.ContextLoaderListener org.springframework.beans.factory...
RabbitMQ在Golang中的高效应用：消息队列最佳实践
Golang编程笔记的博客
04-13 1213
在分布式系统架构中，消息队列作为异步通信的核心组件，承担着解耦服务、削峰填谷、异步处理的重要角色。RabbitMQ作为开源消息中间件的代表，以其强大的路由能力、灵活的协议支持和生态兼容性被广泛应用。Golang（简称Go）凭借高效的并发模型、简洁的语法和原生支持高性能网络IO的优势，成为构建RabbitMQ客户端的理想选择。本文聚焦RabbitMQ在Go语言环境中的工程化实践，涵盖核心概念解析、协议适配、性能优化、异常处理、实战案例等完整技术链路。
rabbitmq消息投递失败
Casual_Lei的博客
07-15 1104
使用Confirm模式和确保消息从生产者正确发送到交换机和队列。使用手动消息确认机制处理消费者无法处理的消息。配置死信队列处理无法处理或过期的消息。确保消息处理逻辑具有幂等性，以防止重复处理导致的数据不一致。通过这些方法，可以提高消息系统的可靠性和健壮性，确保消息不会丢失或重复处理。
大数据领域 RabbitMQ 的消息队列性能调优实战
AI天才研究院
05-10 837
在大数据时代，消息队列作为系统解耦和异步处理的关键组件，其性能直接影响整个数据处理管道的效率。RabbitMQ作为最流行的开源消息代理之一，在大数据领域有着广泛应用。本文旨在提供一套完整的RabbitMQ性能调优方法论，帮助开发者在高并发、大数据量场景下最大化消息队列的性能。本文首先介绍RabbitMQ的核心概念，然后深入分析性能影响因素，接着提供具体的调优策略和实战案例，最后讨论实际应用场景和未来发展趋势。: RabbitMQ实现的高级消息队列协议Exchange。
Golang与RabbitMQ整合：解决分布式系统通信难题
Golang编程笔记的博客
04-23 925
在分布式系统架构中，服务间通信的可靠性、可扩展性和解耦能力是核心挑战。传统RPC调用面临服务耦合度高、容错能力弱等问题，而消息队列通过异步通信模式有效解决这些痛点。RabbitMQ作为实现AMQP协议的开源消息中间件，以高可靠性、灵活路由和多语言支持著称，Golang凭借其高效的并发模型和简洁的语法，成为构建分布式系统的理想选择。本文旨在系统讲解Golang与RabbitMQ的整合技术，涵盖基础原理、核心算法、实战案例及性能优化，帮助开发者掌握分布式通信的关键技术。核心概念。
Failed to declare queue(s):[QUEUE_TENANT_SCAN]
it佳佳的博客
09-25 3152
org.springframework.amqp.rabbit.listener.BlockingQueueConsumer$DeclarationException: Failed to declare queue(s):[QUEUE_TENANT_SCAN] at org.springframework.amqp.rabbit.listener.BlockingQueueConsumer.attemptPassiveDeclarations(BlockingQueueConsumer.java:700
Failed to declare queue(s):[topic.man]
qq_36090537的博客
11-22 1183
org.springframework.amqp.rabbit.listener.BlockingQueueConsumer$DeclarationException: Failed to declare queue(s):[topic.man]
解决SpringAMQP工作队列模型程序报错：WARN 48068:Failed to declare queue: simple.queue
jungleirim的博客
02-22 983
具体代码如下：也就是官网中简单模型的hello world案例。当然，主机名，端口号，账户密码这些需要根据实际情况修改。
【完美解决】SpringBoot整合rabbitmq “Failed to declare queue(s)“
shang_0122的博客
05-30 3万+
【完美解决】SpringBoot整合rabbitmq "Failed to declare queue(s)"
Failed to declare queue(s):[XXX]问题解决
qq_42330678的博客
04-07 1万+
Failed to declare queue(s):[XXX]问题解决 起因 今天我在捣鼓RabbitMQ的时候,要去配置手动确认机制,结果就发生了这个错误! 查找问题 这个错误说明是要不这个队列的名字不存在,要不就是代码中的名字写错了!于是,便开始排查问题. 首先去RabbitMq的页面上查看队列是不是存在. RabbitMq上的队列存在,说明不是它的问题,那就是代码问题了. 已经找到问题 . 这里应该写队列的名字, 结果协成了交换机的. 总结 遇到问题不要着急 , 我开始的时候就比较着急 ,
解决Failed to declare queue(s):[XXX]报错问题
热门推荐
MoLi blog
04-07 4万+
如果在使用RabbitMQ消息中间件时发生此异常 请检查是否有这个名为XXX的消息队列
Springboot测试RabbitMQ出现Failed to declare queue(s)
weixin_41957432的博客
07-21 2893
Springboot测试RabbitMQ出现Failed to declare queue(s)
no queue ‘XXX‘ in vhost ‘/‘ 或 Failed to declare queue(s):[XXX] queue没建立，message也回不了家
java_jiawawa的博客
01-27 1万+
org.springframework.context.ApplicationContextException: Failed to start bean 'org.springframework.amqp.rabbit.config.internalRabbitListenerEndpointRegistry'; nested exception is org.springframework.amqp.AmqpIllegalStateException: Fatal exception on listen
RabbitMQ启动报错：DeclarationException: Failed to declare queue
且行且珍惜_super的博客
10-20 3946
解决思路：一开始以为是rabbitmq上有问题，但是另一个项目能启动，排除这个问题。代码的问题也花了时间排除掉。 具体原因：之前项目启动时已声明交换机和队列并且持久化，后来修改代码后交换机的名字跟之前的相同，但是交换机的类型不同，到rabbitmq的界面上把之前声明的交换机删除，项目即可正常启动。 ...
rabbitmq 不使用redis db校验messageId来确定消息被消费，怎么避免多个消费者重复消费消息
04-28
在 RabbitMQ 中，为了避免多个消费者重复消费消息（即确保消息的幂等性），可以通过以下几种方式来实现，而不依赖 Redis 或数据库校验 `messageId`。 ### 方法1：使用 RabbitMQ 的消息去重插件 RabbitMQ 社区提供了一个名为 `rabbitmq-deduplication` 的插件，可以用来自动去重消息。这个插件会根据消息的 `x-deduplication-header` 或 `message-id` 字段来判断消息是否已经被消费过。 #### 实现步骤： 1. **安装插件**： 下载并启用 `rabbitmq-deduplication` 插件。 ```bash rabbitmq-plugins enable rabbitmq_deduplication ``` 2. **配置队列**： 在声明队列时，启用去重功能。 ```python import pika connection = pika.BlockingConnection(pika.ConnectionParameters('localhost')) channel = connection.channel() # 声明一个启用了去重的队列 channel.queue_declare(queue='dedup_queue', arguments={'x-deduplication': True}) connection.close() ``` 3. **发送带有唯一标识的消息**： 在发送消息时，设置 `message-id` 或其他唯一标识符。 ```python import pika connection = pika.BlockingConnection(pika.ConnectionParameters('localhost')) channel = connection.channel() properties = pika.BasicProperties(message_id="unique_message_id_123") channel.basic_publish(exchange='', routing_key='dedup_queue', body='Hello World!', properties=properties) connection.close() ``` 4. **消费消息**： 消费者正常消费消息即可，插件会自动处理去重。 ```python def callback(ch, method, properties, body): print(f"Received {body}") channel.basic_consume(queue='dedup_queue', on_message_callback=callback, auto_ack=True) channel.start_consuming() ``` #### 解释： - `rabbitmq-deduplication` 插件会在消息进入队列之前检查其唯一性。 - 如果消息已经存在，则直接丢弃该消息，避免重复消费。 --- ### 方法2：消费者端实现幂等性逻辑 如果不使用插件，可以在消费者端通过业务逻辑实现幂等性。例如，将消息的 `message-id` 存储在内存中（如 Python 的集合 `set`）或本地文件中，并在消费前检查是否已经处理过该消息。 #### 实现代码： ```python import pika # 用于存储已消费的消息ID consumed_message_ids = set() def callback(ch, method, properties, body): message_id = properties.message_id if message_id in consumed_message_ids: print(f"Message {message_id} already processed, skipping...") ch.basic_ack(delivery_tag=method.delivery_tag) return # 处理消息 print(f"Processing message: {body}") consumed_message_ids.add(message_id) # 确认消息已被成功处理 ch.basic_ack(delivery_tag=method.delivery_tag) connection = pika.BlockingConnection(pika.ConnectionParameters('localhost')) channel = connection.channel() channel.queue_declare(queue='my_queue') channel.basic_consume(queue='my_queue', on_message_callback=callback) print('Waiting for messages...') channel.start_consuming() ``` #### 解释： - 使用一个集合 `consumed_message_ids` 来记录已经消费过的消息 ID。 - 在每次消费消息之前，先检查该消息 ID 是否已经存在于集合中。 - 如果已经存在，则跳过处理；否则，处理消息并将消息 ID 添加到集合中。 --- ### 方法3：使用 RabbitMQ 的事务机制 RabbitMQ 提供了事务机制，可以通过确认机制（Acknowledgment）来确保消息只被消费一次。 #### 实现代码： ```python import pika def callback(ch, method, properties, body): try: # 模拟消息处理 print(f"Processing message: {body}") # 确认消息已被成功处理 ch.basic_ack(delivery_tag=method.delivery_tag) except Exception as e: print(f"Failed to process message: {e}") ch.basic_nack(delivery_tag=method.delivery_tag, requeue=False) # 不重新入队 connection = pika.BlockingConnection(pika.ConnectionParameters('localhost')) channel = connection.channel() channel.queue_declare(queue='my_queue') channel.basic_consume(queue='my_queue', on_message_callback=callback, auto_ack=False) print('Waiting for messages...') channel.start_consuming() ``` #### 解释： - `auto_ack=False` 表示消费者不会自动确认消息。 - 在消息处理完成后，显式调用 `basic_ack` 确认消息已被成功处理。 - 如果处理失败，则调用 `basic_nack` 并设置 `requeue=False`，确保消息不会重新入队。 --- ### 方法4：使用 RabbitMQ 的死信队列（DLX） 如果某些消息可能因为幂等问题需要特殊处理，可以使用死信队列（Dead Letter Exchange）来隔离这些消息。 #### 实现代码： ```python import pika def callback(ch, method, properties, body): try: # 模拟消息处理 print(f"Processing message: {body}") # 确认消息已被成功处理 ch.basic_ack(delivery_tag=method.delivery_tag) except Exception as e: print(f"Failed to process message: {e}") ch.basic_reject(delivery_tag=method.delivery_tag, requeue=False) # 将消息发送到死信队列 connection = pika.BlockingConnection(pika.ConnectionParameters('localhost')) channel = connection.channel() # 声明普通队列和死信队列 channel.queue_declare(queue='normal_queue', arguments={ 'x-dead-letter-exchange': 'dlx_exchange', 'x-dead-letter-routing-key': 'dlx_routing_key' }) channel.queue_declare(queue='dlx_queue') channel.exchange_declare(exchange='dlx_exchange', exchange_type='direct') channel.queue_bind(queue='dlx_queue', exchange='dlx_exchange', routing_key='dlx_routing_key') channel.basic_consume(queue='normal_queue', on_message_callback=callback, auto_ack=False) print('Waiting for messages...') channel.start_consuming() ``` #### 解释： - 如果消息处理失败，可以通过 `basic_reject` 将消息发送到死信队列。 - 死信队列中的消息可以单独处理或分析。 --- ### 总结 以上方法都可以避免多个消费者重复消费消息。具体选择哪种方法取决于你的业务需求和技术栈。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值