RabbitMQ 生产端可靠投递(confirm、return、重试)

这篇解决生产端"消息到底到没到"的问题:如何做到可确认、可补偿、可追踪。

先说结论

可靠投递要做到三件事:

  1. 开启 publisher confirm,确认消息有没有到 Broker
  2. 开启 return,确认路由失败的消息能回来
  3. 发送失败要重试,但必须有上限 + 退避

一、两种"失败"要分清

  1. 发送失败:消息没到 Broker(比如网络抖动)
  2. 路由失败:消息到了交换机,但找不到队列

这两个失败场景的处理方式完全不同。


二、confirm 机制(消息是否到 Broker)

1) 开启确认机制

yaml 复制代码
spring:
  rabbitmq:
    publisher-confirm-type: correlated

2) 发送时带 correlationId

java 复制代码
CorrelationData correlationData = new CorrelationData(UUID.randomUUID().toString());
rabbitTemplate.convertAndSend(exchange, routingKey, message, correlationData);

3) 监听确认回调

java 复制代码
rabbitTemplate.setConfirmCallback((correlationData, ack, cause) -> {
    if (ack) {
        // 记录成功
    } else {
        // 发送失败,进入重试或落库
    }
});

三、return 机制(消息是否路由到队列)

1) 开启 return

yaml 复制代码
spring:
  rabbitmq:
    publisher-returns: true
    template:
      mandatory: true

2) 监听 return

java 复制代码
rabbitTemplate.setReturnsCallback(returned -> {
    // returned.getMessage()
    // returned.getReplyText()
    // returned.getExchange()
    // returned.getRoutingKey()
    // 路由失败,需人工处理或补偿
});

如果 confirm 成功但 return 触发,说明消息到了交换机却没队列接收。


四、重试策略(别无限重发)

推荐最简单可用的策略:

  • 1s
  • 5s
  • 30s
  • 2min
  • 10min
  • 超过 5 次进入失败队列

伪代码:

java 复制代码
if (retryCount > 5) {
    // 记录失败,告警
} else {
    // 延迟重试发送
}

五、一个完整可用的发送器

java 复制代码
@Component
public class ReliableProducer {

    @Resource
    private RabbitTemplate rabbitTemplate;
    @Resource
    private MessageSendLogService sendLogService;

    public void send(String exchange, String routingKey, Object payload) {
        String msgId = UUID.randomUUID().toString();
        CorrelationData cd = new CorrelationData(msgId);

        // 先落库(状态=发送中)
        sendLogService.saveSending(msgId, payload);

        rabbitTemplate.convertAndSend(exchange, routingKey, payload, cd);
    }

    @PostConstruct
    public void initCallbacks() {
        rabbitTemplate.setConfirmCallback((cd, ack, cause) -> {
            if (ack) {
                sendLogService.markSuccess(cd.getId());
            } else {
                sendLogService.markFail(cd.getId(), cause);
            }
        });

        rabbitTemplate.setReturnsCallback(ret -> {
            sendLogService.markRouteFail(
                ret.getMessage().getMessageProperties().getMessageId(),
                ret.getReplyText()
            );
        });
    }
}

六、推荐的工程化落地

  1. 消息落库 :发送前写一条 message_log
  2. 确认回调更新状态
  3. 失败消息进入补偿任务
  4. 监控指标:发送失败率、路由失败率、补偿成功率

这样你才知道"有没有丢",也才有"补救路径"。


最后总结

生产端可靠投递不是"一个开关",而是一套闭环:

  1. confirm 保证到 Broker
  2. return 保证到 Queue
  3. 失败可重试、可补偿、可追踪

做到这些,消息才真的"可靠"。

相关推荐
AI源码3 小时前
基于Spark的期刊推荐系统的设计与实现
大数据·分布式·spark
goehou21 小时前
Kafka 的默认配置适合演示,不适合生产
kafka·消息队列·幂等·ai agent
国科安芯1 天前
CAN FD一升到5Mbps就误码:位定时、终端与共模的现场排查顺序——ASM1042S2S在星载分布式总线中的FAE实践
分布式·安全·架构·canfd·dcdc·抗辐射·载荷
西木Qi2 天前
Kafka消息中间件单机版安装配置
分布式·kafka
OriginCoding2 天前
一个 JDK 跑起六个分布式挑战:Kotlin 版 Gossip Glomers(一)
分布式·kotlin
stark张宇3 天前
分布式事务方案设计与选型思考:2PC、TCC
分布式·架构
时间的拾荒人3 天前
Redis 典型应用:缓存与分布式锁原理
redis·分布式·缓存·面试·架构
codigger3 天前
飞书群聊已读,是怎么实现的?
消息队列·后端开发·#架构设计
筑梦之人4 天前
Elasticsearch 9.x 从入门到精通(5/7):集群、分布式与运维
运维·分布式·elasticsearch
kiwixing5 天前
GaussDB|集中式还是分布式?三把尺子选型
分布式·gaussdb