MQTT断线重连及订阅消息恢复

最新推荐文章于 2025-10-29 15:55:15 发布
原创 最新推荐文章于 2025-10-29 15:55:15 发布 · 6.6k 阅读 · 12 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#物联网

本文探讨了MQTT客户端在断线后如何重连并恢复订阅消息的问题。通过设置`cleanSession`为false，客户端可以接收到离线期间的主题消息，但需要重新订阅。另外，实现`MqttCallbackExtended`接口并在连接成功时重新订阅主题也是一种方法。最后，通过深入MQTT源码，找到在连接成功时触发重连回调的方法，解决了重连后无法订阅的问题。

MQTT断线重连及订阅消息恢复

工具
MQTT客户端是用的 paho http://www.eclipse.org/paho/

问题
采用以下配置

connOpts = new MqttConnectOptions(); 
    connOpts.setCleanSession(true);
    connOpts.setConnectionTimeout(10);
    connOpts.setKeepAliveInterval(90);
    connOpts.setAutomaticReconnect(true);

网络断开后，客户端会进行重连，但是重连之前订阅的主题就失效了，不再接受之前订阅主题的消息。

解决方法
因为配置里将cleanSession 设为 true ，当客户端掉线时 ，服务器端会清除 客户端 session 。 重连后 客户端会有一个新的session。

第一种

把配置里的 cleanSession 设为false，客户端掉线后 服务器端不会清除session，当重连后可以接收之前订阅主题的消息。当客户端上线后会接受到它离线的这段时间的消息

但是这个只是进行了重连，重连后还需要再次发起订阅

对于离线消息为什么不能接收到，我想说的是 你很有可能在再次连接的时候又重新订阅了该topic。这样是接收不到离线消息的。
离线消息是订阅了某个topic的client 在断开连接以后，在接下来又重新连接的时候，任然可以收到在它断开连接的这段时间内，该topic上的消息。这就需要将client的 setCleanSession 设置为false，这样服务器才能保留它的session，再次建立连接的时候，它就会继续使用这个session了。

注意：clientId 是不能更改的。

第二种

通过查看MqttClient的 connect 方法的代码发现 会调到MqttAsyncClient 的connect

	public IMqttToken connect(MqttConnectOptions options, Object userContext, IMqttActionListener callback) throws MqttException, MqttSecurityException {
   
   
		......
		//省略
		......
		if (this.mqttCallback instanceof MqttCallbackExtended) {
   
   
			connectActionListener.setMqttCallbackExtended((MqttCallbackExtended) this.mqttCallback);
		}

		comms.setNetworkModuleIndex(0);
		connectActionListener.connect();

		return userToken;
	}

如果我们设置的 mqttClient.setCallback(mqttCallback); mqttCallback实现了 MqttCallbackExtended接口，就会把它设置给connectActionListener，我再来看看MqttCallbackExtended接口。

public interface MqttCallbackExtended extends
最低0.47元/天 解锁文章
MQTT消息传输过程，网络断开后，断线重连及订阅消息恢复
pvmsmfchcs的博客
08-08 4933
2，一定要设置发送超时，默认是-1，是不断进行发送的，会被长阻塞在这里，单位是ms。1，首先要在网络失败的地方进行client重连。
MQTT从入门到放弃
weixin_38446891的博客
07-14 3013
mqtt
使用mqttv3.MqttClient建立Mqtt连接
最新发布
i土豆程序猿的学习笔记
10-29 109
摘要：本文介绍了使用Kotlin实现MQTT客户端连接的代码示例。首先引入MQTT库依赖，然后通过MqttConnectOptions配置连接参数（包括超时、自动重连、SSL验证等），使用MqttClient建立连接。连接成功后订阅指定主题消息，并提供了发布消息的方法。代码采用了单例模式封装连接管理，包含连接信息类MqttConnectInfo和自动重连机制。连接配置支持用户名密码认证，并设置了遗愿消息用于异常断开通知。
MQTT源码解析
hacker_crazy的专栏
03-20 2305
一、MQTT的创建和connect流程 1.Android端实现mqtt，首先会new一个MqttAndroidClient，并传入需要的参数。 首先，MqttAndroidClient是如何创建的呢？ public MqttAndroidClient(Context context, String serverURI, String clientId, MqttClientPers...
java-MQTT的使用原理讲解
人的一生就是在学习的道路上不断进步
03-28 9562
前端时间因为工作需求研究了mqtt客服端（时间有点久远记不太清楚了）。 工作场景是这样的：房间内有警报的硬件，每次按警报时，硬件会发布一次主题，而我们需要接受这个主题信息，并把主题内的相关数据插入到数据库。硬件是第三方的，发布消息由第三方完成，我们只需要订阅消息。 所写demo可自行下载（https://download.youkuaiyun.com/download/weixin_44451527/85047878） 解析数据后如下图（根据实际情况进行相对应的解析） MQTT是一个基于客户端-服务器的消息发布/订阅传
MQTT 客户端断线重连机制设计与实现
moton2017的博客
05-23 1763
MQTT 是构建于 TCP 之上的轻量级发布/订阅通信协议，适用于低带宽、不稳定网络的物联网设备通信。 断线重连机制：指客户端在与 Broker（消息服务器）断开连接后，自动重试连接、重订阅、恢复会话、补发消息等。
JavaScript开发Mqtt应用的MQTT库（mqtt.js,支持断开后自动重连）
04-30
用户端采用JavaScript开发Mqtt应用时，一般会采用第三方MQTT库。网上很多资源断开后不能自动重连，该资源支持断开后自动重连（亲测）。reconnect : true，即可。需要demo的同行留言。
python mqtt 实现消息订阅+消息推送 支持断线重连 ，自动重连，保活不掉线
qq_28367963的博客
04-30 1424
【代码】python mqtt 实现消息订阅+消息推送 支持断线重连 ，自动重连，保活不掉线。
mqtt c异步客户端SDK，支持断网重连
01-22
基于paho mqtt c 版本的客户端SDK，采用异步模式，连接，订阅等采用回调模式。支持断网重连。
java实现mqtt的发送和订阅
05-06
java实现mqtt的发送和订阅,代码中有详细的注释，是分服务端和客户端来测试的，并有断开重连的处理！
JAVA MQTT断开重连,重新原先所有订阅主题
qq_39228898的博客
04-20 5574
java MQTT 断开重连,重新订阅
mqtt session保持 订阅消息_MQTT断线重连及订阅消息恢复
weixin_30578645的博客
12-24 1839
问题采用以下配置connOpts = new MqttConnectOptions();connOpts.setCleanSession(true);connOpts.setConnectionTimeout(10);connOpts.setKeepAliveInterval(90);connOpts.setAutomaticReconnect(true);网络断开后，客户端会进行重连，但是重连之...
springboot与mqtt的订阅与重连订阅
一个不断前行的程序者
02-11 3864
使用mqtt的过程中，异常情况下mqtt断线时目前在mqtt的源码中，有存在mqtt的自动重连机制，但是自动重连后不能够接收到已经监听过的topic。
MQTT 客户端自动重连最佳实践｜构建可靠 IoT 设备连接
emqx_broker的博客
03-30 3216
本文介绍在MQTT客户端代码实现过程中，自动重连逻辑设计的重要性与示例，帮助读者设计更为合理的重连代码，构建更加稳定可靠的物联网设备连接。
SpringBoot 开发之 MQTT 协议客户端断线后自动重连与保留断线时发布的主题消息
热门推荐
myinsert的博客
08-04 1万+
1.消息订阅 clientId clientId即连接MQTT的客户端ID，一般以客户端唯一标识符表示，MemoryPersistence设置clientId的保存形式，默认以内存保存。 subscribe() 方法 订阅一个主题，实时接收主题消息。 每一次订阅都会收到一次Retained 保留的消息。但是多次订阅并不会导致重复接收离线消息。 setAutomaticReconnect() 方法 值为 true 时表示断开后重连。 setCleanSession() 方法 设置服务器是否清空客户端sessi
MQTT 客户端重连（Java paho）
axe的专栏
08-04 9757
MQTT客户端重连主要有两种方法 第一种：自动重连 设置org.eclipse.paho.client.mqttv3.MqttConnectOptions#setAutomaticReconnect为true MqttConnectOptions options = new MqttConnectOptions(); options.setAutomaticReconnect(true); 然后callback实现org.eclipse.paho.client.mqttv3.MqttCallbackExt
mqtt如何接收重连前的消息
10-16
<think>首先，用户的问题是：“我想查找MQTT接收重连前消息的方法 请问MQTT接收重连前消息的解决方案”。这是在询问如何确保MQTT客户端在重连后能接收到在断开连接期间发送到订阅主题的消息。 回顾系统级指令： - 回答必须使用中文。 - 行内数学表达式使用$...$格式，但这个问题可能不涉及数学。 - 独立公式用$$...$$并单独成段。 - LaTeX语法正确。 - 生成相关问题。 - 引用的段落末尾添加引用标识，如[^1]。 - 回答结构清晰，逐步解决问题。 用户提供了几个引用： - [^1]：讨论启用automaticReconnect和调整connectionLost方法。 - [^2]：涉及MqttClient的connect方法，提到MqttCallbackExtended接口。 - [^3]：问题是在重连后订阅丢失，需要重新订阅。 - [^4]：关于优化MQTT接收消息慢的问题，提到性能优化。 - [^5]：MQTT断线重连订阅无法接收，涉及MqttCallbackExtended接口。 用户的实际需求是：在MQTT客户端重连后，如何接收在断开连接期间发送的消息。 关键点： - MQTT协议在QoS级别支持消息持久化： - QoS 0：最多一次（可能丢失）。 - QoS 1：至少一次（服务器会重试）。 - QoS 2：精确一次（保证交付）。 - 为了接收重连前的消息，需要使用QoS 1或2订阅，并且在服务器端设置持久会话。 - 客户端在连接时指定clean session标志： - clean session = false：持久会话，服务器保存订阅和未送达消息。 - clean session = true：临时会话，断开后订阅和消息丢失。 - 在重连时，如果clean session=false，服务器应该恢复订阅和未送达消息。 从引用中提取相关信息： - [^2]和[^5]提到MqttCallbackExtended接口，这在MQTT Paho库中用于处理连接恢复。 - MqttCallbackExtended包括一个方法connectComplete(boolean reconnect, String serverURI)，它在连接完成时调用，包括重连后。 - 在connectComplete方法中，可以重新订阅主题，确保订阅恢复。 - [^1]建议启用automaticReconnect。 - [^3]指出问题：重连后订阅丢失，需要在连接后重新订阅。 - [^4]的优化建议可能相关，但焦点是接收消息慢，不是重连前的消息。 解决方案步骤： 1. **设置clean session为false**：在MQTT连接选项中设置Clean Session为false，以确保服务器保存订阅和消息。 2. **使用QoS 1或2订阅**：订阅主题时使用QoS 1或2，这样服务器会存储未送达消息。 3. **实现MqttCallbackExtended接口**：在客户端代码中实现此接口，特别是connectComplete方法；在重连后，可以在此方法中重新订阅主题。 4. **启用自动重连**：配置客户端启用automaticReconnect。 5. **处理重连逻辑**：在connectionLost方法中，确保有重试机制。 用户指定参考站内引用，所以我应该基于这些引用构建答案。 结构化回答： - 引言：解释问题。 - 逐步解决方案。 - 代码示例（如果需要）。 - 生成相关问题。 引用标记： - 在相关部分末尾添加引用标识，如[^2]。 最终答案应： - 用中文。 - 清晰、逐步。 - 包括生成的相关问题。 生成相关问题： - 基于主题，如：如何设置clean session？QoS级别的影响？如何测试重连行为？ </think>### MQTT接收重连前消息的解决方案 在MQTT客户端断开连接期间，服务器可能会累积发送到订阅主题的消息（取决于QoS级别）。客户端重连后，若配置不当，这些消息可能无法被接收。核心解决方案在于利用MQTT的 **持久会话**（Clean Session = false）和 **自动重连机制**。下面我将基于用户提供的引用内容（特别是引用[1]、[2]、[3]、[5]），逐步解释如何确保客户端在重连后能接收断开连接期间的消息。 #### 1. **启用持久会话（Clean Session = false）** - **目的**：设置Clean Session为false时，MQTT服务器会保存客户端的订阅信息和未送达消息（QoS 1或2）。重连后，服务器自动恢复这些消息。 - **实现方法**： - 在MQTT连接选项（`MqttConnectOptions`）中设置`setCleanSession(false)`。 - 示例代码（Java/Paho库）： ```java MqttConnectOptions options = new MqttConnectOptions(); options.setCleanSession(false); // 开启持久会话 options.setAutomaticReconnect(true); // 启用自动重连，引用[1]的建议 client.connect(options); ``` - **注意**：必须使用QoS 1或2订阅主题（QoS 0不支持消息持久化）。 #### 2. **实现`MqttCallbackExtended`接口以处理重连订阅** - **目的**：引用[2]和[5]提到，`MqttCallbackExtended`接口在连接恢复时触发`connectComplete`方法。在此方法中重新订阅主题，确保订阅列表恢复，从而接收历史消息[^2][^5]。 - **步骤**： - **步骤一**：创建自定义回调类，实现`MqttCallbackExtended`。 ```java public class CustomMqttCallback implements MqttCallbackExtended { @Override public void connectComplete(boolean reconnect, String serverURI) { if (reconnect) { // 重连后重新订阅主题 try { client.subscribe("topic", 1); // QoS 1确保消息恢复 } catch (MqttException e) { e.printStackTrace(); } } } @Override public void connectionLost(Throwable cause) { // 连接丢失时处理，可添加延时重试逻辑，引用[1]建议调整connectionLost方法 } // 其他方法如messageArrived、deliveryComplete需实现 @Override public void messageArrived(String topic, MqttMessage message) { // 处理接收到的消息 } @Override public void deliveryComplete(IMqttDeliveryToken token) {} } ``` - **步骤二**：将回调类设置给客户端。 ```java MqttClient client = new MqttClient(broker, clientId); client.setCallback(new CustomMqttCallback()); ``` - **关键点**：`connectComplete`方法中的`reconnect`参数为true时表示是重连场景，在此重新订阅主题，避免引用[3]中提到的“订阅丢失”问题[^3]。 #### 3. **配置自动重连和消息恢复优化** - **启用自动重连**：引用[1]建议启用`automaticReconnect`，确保客户端自动尝试重连[^1]。 - 在`MqttConnectOptions`中设置：`options.setAutomaticReconnect(true);`。 - **优化消息处理**：引用[4]提到性能优化，确保消息处理高效，避免阻塞线程[^4]。 - 在`messageArrived`方法中使用异步处理： ```java @Override public void messageArrived(String topic, MqttMessage message) { CompletableFuture.runAsync(() -> { // 异步处理消息，减少延迟 }); } ``` - 调整QoS级别：优先使用QoS 1（至少一次），平衡可靠性和效率；如有必要，增加飞行窗口大小（`setMaxInflight`）。 #### 4. **测试注意事项** - **验证消息恢复**：模拟断线场景（如手动断开网络），重连后检查是否收到断开期间的消息。 - **常见问题排查**： - 如果消息未恢复，检查Clean Session是否设为false。 - 确保服务器支持持久会话（如Mosquitto或AWS IoT默认支持）。 - 引用[3]指出，重连前订阅无效，必须在`connectComplete`中处理[^3]。 通过以上步骤，您可以确保MQTT客户端在重连后接收到断开前的消息。核心是持久会话和`MqttCallbackExtended`接口的正确实现。引用[1]、[2]、[5]强调了自动重连和回调机制的关键作用[^1][^2][^5]。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值