连接与订阅

连接状态、会话与重连

判断当前生命周期,理解自动重连与 Clean Session 的实际边界。

浏览全部手册
本页目录

状态与操作

状态 含义 可执行操作
未连接 当前没有可用 MQTT 会话 连接
连接中 正在建立会话 终止
已连接 可以发起订阅和发布 断开
重连中 正在恢复中断的连接 停止重连
失败或错误提示 连接尝试未完成 阅读日志、修正后重试

自动重连

在「设置 → 连接默认值」中启用或关闭「自动重连」,保存后在下一次连接时使用该策略。它不能修复错误密码、缺少权限或错误端口。

连接恢复后工具会处理保存的订阅。仍应检查订阅状态和一条实际接收记录,不要仅凭连接状态判断每个主题都已恢复。

主动停止

测试结束时使用「断开」或「停止重连」。定时发送会在当前连接离开已连接状态时停止;恢复连接后需要你重新确认并启动。

自动重连并不意味着工具会在应用关闭后继续通信。

Clean Session 是什么

在 MQTT 3.1.1 中,Clean Session 影响 broker 对会话状态的处理。需要持久会话时,还必须考虑固定 Client ID、broker 策略和消息 QoS。

**当前实现限制:**设置页虽然提供 Clean Session,但连接建立使用已保存连接自身的会话字段;新建连接目前默认启用清理会话。全局设置值尚未接入新建连接赋值流程,不能靠切换该设置来保证持久会话生效。

因此,本手册不提供基于该开关的离线消息接收保证。需要验证会话语义时先记录版本、broker 设置与具体结果。

常见判断

反复掉线先检查 Client ID 冲突、broker 日志、Keep Alive 和网络稳定性。连接成功但没有消息,继续检查订阅与发布权限,而不是不断点击重连。

仍有疑问?按反馈清单整理复现信息 →