连接状态、会话与重连
判断当前生命周期,理解自动重连与 Clean Session 的实际边界。
浏览全部手册
本页目录
状态与操作
| 状态 | 含义 | 可执行操作 |
|---|---|---|
| 未连接 | 当前没有可用 MQTT 会话 | 连接 |
| 连接中 | 正在建立会话 | 终止 |
| 已连接 | 可以发起订阅和发布 | 断开 |
| 重连中 | 正在恢复中断的连接 | 停止重连 |
| 失败或错误提示 | 连接尝试未完成 | 阅读日志、修正后重试 |
自动重连
在「设置 → 连接默认值」中启用或关闭「自动重连」,保存后在下一次连接时使用该策略。它不能修复错误密码、缺少权限或错误端口。
连接恢复后工具会处理保存的订阅。仍应检查订阅状态和一条实际接收记录,不要仅凭连接状态判断每个主题都已恢复。
主动停止
测试结束时使用「断开」或「停止重连」。定时发送会在当前连接离开已连接状态时停止;恢复连接后需要你重新确认并启动。
自动重连并不意味着工具会在应用关闭后继续通信。
Clean Session 是什么
在 MQTT 3.1.1 中,Clean Session 影响 broker 对会话状态的处理。需要持久会话时,还必须考虑固定 Client ID、broker 策略和消息 QoS。
**当前实现限制:**设置页虽然提供 Clean Session,但连接建立使用已保存连接自身的会话字段;新建连接目前默认启用清理会话。全局设置值尚未接入新建连接赋值流程,不能靠切换该设置来保证持久会话生效。
因此,本手册不提供基于该开关的离线消息接收保证。需要验证会话语义时先记录版本、broker 设置与具体结果。
常见判断
反复掉线先检查 Client ID 冲突、broker 日志、Keep Alive 和网络稳定性。连接成功但没有消息,继续检查订阅与发布权限,而不是不断点击重连。
仍有疑问?按反馈清单整理复现信息 →