Spring Boot RabbitMQ Listener启动后创建重复同名队列问题排查

核心原因 #

1. RabbitMQ 同一虚拟主机（vhost）下不允许存在同名队列，队列的唯一性判定不仅看名称，还要求所有属性参数完全一致，包括x-dead-letter-exchange、x-dead-letter-routing-key、x-message-ttl这类扩展配置。
2. 未配置死信队列时，生产者和消费者声明的队列都仅配置了持久化属性，参数完全匹配，因此运行正常。添加死信配置后，生产者端的队列新增了3个扩展参数，但消费者端的队列声明逻辑没有同步修改，导致参数不匹配：
   • 初始消费者配置中，@RabbitListener注解内的@Queue仅配置了持久化属性，没有死信和TTL相关参数，Spring AMQP启动时会尝试按照注解配置声明队列，和生产者已经创建的队列参数冲突。
   • 后续你新增了消费者端的Queue Bean，但@RabbitListener的@QueueBinding逻辑没有关联这个自定义Bean，还是按照注解内的参数声明队列，参数依旧不匹配，因此问题没有解决。

修复方案 #

你可以根据实际场景选择任意一种方案：

• 方案一：消费者端仅消费，不自动声明队列（适合生产端统一管理队列/交换机声明的生产场景）
  在@Queue注解中添加declare = "false"关闭自动声明即可：

  @RabbitListener(bindings = @QueueBinding(value = @Queue(value = "${queuename}", durable = "true", declare = "false"),
          exchange = @Exchange(value = "exchange"),key = "routingkey"))
  

• 方案二：消费者端同步队列参数，保证和生产者端完全一致
  如果你需要消费者也支持自动创建队列，有两种实现方式：
  • 直接引用已配置的队列Bean，不需要在@RabbitListener里重复配置绑定：

    @RabbitListener(queues = "${queuename}")
    

  • 或者在@Queue注解中补全所有和生产者一致的扩展参数：

    @Queue(value = "${queuename}", durable = "true", 
        arguments = {
            @Argument(name = "x-dead-letter-exchange", value = "${dlqExchange}"),
            @Argument(name = "x-dead-letter-routing-key", value = "${deadLetterRoutingKey}"),
            @Argument(name = "x-message-ttl", value = "${messageTTL}", type = "java.lang.Long")
        })
    

内容的提问来源于stack exchange，提问作者Learning Developer