Spring Cloud Stream RabbitMQ怎么配置死信和重试逻辑？-java教程-PHP中文网

必须开启auto-bind-dlq: true并正确配置max-attempts，否则重试耗尽后消息会被broker直接丢弃而非进入死信队列；republish-to-dlq: true缺失、acknowledge-mode非auto或异常被吞、配置未置于rabbit.bindings命名空间下，均会导致dlq失效。

必须开启 auto-bind-dlq 并配好 max-attempts，否则重试失败的消息不会进死信队列，而是直接丢弃或无限循环。

为什么消息重试后没进死信队列？

常见现象是：消费者抛出异常、max-attempts 设为 3，但重试 3 次后消息消失，死信队列里空空如也。

auto-bind-dlq: true 缺失 —— 这是最常见的漏配项，不加它，Spring 不会自动声明死信交换机、死信队列和绑定关系
republish-to-dlq: true 未设 —— 即使开了 auto-bind-dlq，若没开这个，重试耗尽后消息仍会被拒绝（basic.reject(requeue=false)），但不会转发到 DLQ，而是被 Broker 直接丢弃
acknowledge-mode 是 auto 但业务里 try-catch 吞了异常 —— Spring 只在未捕获异常时才触发重试；吞掉异常 = 视为成功消费
用的是 MANUAL 确认模式但没调 channel.basicNack(tag, false) —— 手动模式下，必须显式 nack 并设 requeue=false，否则消息会重回队列无限重试

`spring.cloud.stream.rabbit.bindings.xxx.consumer` 配置项怎么填？

关键配置必须落在 RabbitMQ 专属命名空间下，写在通用 spring.cloud.stream.bindings.xxx.consumer 下无效。

max-attempts: 3 → 写在 spring.cloud.stream.bindings.xxx.consumer.max-attempts，表示本地重试次数（含首次消费）
auto-bind-dlq: true → 必须写在 spring.cloud.stream.rabbit.bindings.xxx.consumer.auto-bind-dlq
republish-to-dlq: true → 同样要写在 rabbit.bindings 下，否则不生效
dead-letter-queue-name: my-topic.my-group.dlq → 可选，不设则用默认名：{destination}.{group}.dlq
ttl: 60000 → 可单独控制消息在队列中存活时间，超时即变死信；和重试逻辑正交，可叠加使用

死信队列名字到底是啥？要不要手动声明？

如果启用了 auto-bind-dlq: true，Spring Boot 会在启动时自动声明一个名为 {destination}.{group}.dlq 的队列，并绑定到内置的 amq.default 死信交换机（RabbitMQ 默认提供），无需手动 @Bean 声明。

Upload audio to AIOZ Stream

快速上传音频至 AIOZ Stream API。支持默认或自定义编码配置创建音频对象，上传文件并完成处理后返回音频链接。

下载

例如 destination: order-topic + group: payment → 死信队列名自动为 order-topic.payment.dlq
如果你自定义了 dead-letter-queue-name，那名字就按你写的来，但依然由 Spring 自动声明
手动声明 Queue + Binding 是冗余的，除非你要改路由键、加参数（如 x-message-ttl）或复用已有 DLQ
注意：DLQ 本身不支持自动重试，它只是个“收容所”，需要另起一个消费者监听该队列做人工干预或二次投递