spring.rabbitmq.publisher-returns与template.mandatory=true有何区别？

这两个配置看似功能重叠，实则是全局开关与具体规则的层级关系，核心差异体现在以下几点：

1. 作用层级与范围不同 #

• spring.rabbitmq.publisher-returns=true：这是全局生效的功能开关，用来开启Spring RabbitMQ对Broker返回未路由消息的监听支持。如果不开启这个配置，哪怕设置了mandatory=true，生产者也无法收到任何返回消息——因为底层的返回监听机制没启动。
• spring.rabbitmq.template.mandatory=true：这是RabbitTemplate级别的规则配置，属于RabbitMQ协议层面的参数。它指定：当消息发送到Exchange后无法匹配任何队列路由规则时，Broker是否要把这条消息回传给生产者（而不是直接丢弃或转发到备用Exchange）。

2. 生效逻辑的依赖关系 #

两者不是“二选一生效”，而是需要配合使用才能触发未路由消息的返回：

• 只有当publisher-returns=true（开启监听）且mandatory=true（Broker返回规则）同时满足时，生产者才能通过ReturnsCallback收到未路由消息的详细信息（比如Exchange名称、路由键、消息内容等）。
• 如果仅开启publisher-returns=true但mandatory=false，Broker会直接丢弃未路由消息，生产者收不到返回。
• 如果仅设置mandatory=true但publisher-returns=false，即使Broker发送了返回消息，Spring未启动监听机制，生产者也无法感知到。

3. 扩展场景的区别 #

• publisher-returns除了配合mandatory使用，还支持处理其他类型的Broker返回场景（比如消息发送到Exchange时的异常返回），是整个返回功能的基础开关。
• mandatory则更聚焦于“未路由消息”的处理规则，你也可以在代码中针对单个RabbitTemplate实例单独设置setMandatory(true)，实现不同模板的差异化规则，而publisher-returns是全局统一配置。

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