连接状态、会话与重连
判断当前生命周期,理解自动重连与 Clean Session 的实际边界。
浏览全部手册
本页目录
状态与操作
| 状态 | 含义 | 可执行操作 |
|---|---|---|
| 未连接 | 当前没有可用 MQTT 会话 | 连接 |
| 连接中 | 正在建立会话 | 终止 |
| 已连接 | 可以发起订阅和发布 | 断开 |
| 重连中 | 正在恢复中断的连接 | 停止重连 |
| 失败或错误提示 | 连接尝试未完成 | 阅读日志、修正后重试 |
自动重连
在「设置 → 连接默认值」中启用或关闭「自动重连」,保存后在下一次连接时使用该策略。它不能修复错误密码、缺少权限或错误端口。
连接恢复后工具会处理保存的订阅。仍应检查订阅状态和一条实际接收记录,不要仅凭连接状态判断每个主题都已恢复。
主动停止
测试结束时使用「断开」或「停止重连」。定时发送会在当前连接离开已连接状态时停止;恢复连接后需要你重新确认并启动。
自动重连并不意味着工具会在应用关闭后继续通信。
Clean Session 是什么
在 MQTT 3.1.1 中,Clean Session 影响 broker 对会话状态的处理。需要持久会话时,还必须考虑固定 Client ID、broker 策略和消息 QoS。
以下依据 2026-10-14 核对的 0.1.0 开发源码:Clean Session 全局默认值为「是」。保存设置后,下一次打开「新建连接」会采用该默认值;选择「否」再新建并保存连接,该连接的会话字段为关闭。修改全局设置不会改写已有连接。
建立连接时,Electron 与 Tauri 实现均读取连接自身保存的会话字段;缺少该字段时默认启用 Clean Session。Electron 将关闭值传为 clean: false,Tauri 将其传给原生连接选项。此处说明源码参数传递,不代表本轮已完成两个运行时的原生通信验收。
如需核对关闭后的行为,先断开测试连接,在设置保存 Clean Session「否」,再新建连接并填写固定 Client ID,保存后连接。结合 broker 日志、订阅状态和实际消息验证结果;不要仅凭设置保存成功判断离线消息会被保留。
2026-09-20/21 手册所述“全局设置未用于新建连接”是旧源码快照的限制。历史安装包可能仍采用旧实现;0.1.0 版本号本身不足以区分构建。本轮未发布安装包,也未验证 broker 离线消息或完整持久会话语义。记录客户端构建日期、运行时、broker 设置与具体结果后再作判断。
常见判断
反复掉线先检查 Client ID 冲突、broker 日志、Keep Alive 和网络稳定性。连接成功但没有消息,继续检查订阅与发布权限,而不是不断点击重连。
仍有疑问?按反馈清单整理复现信息 →