连接与订阅

连接状态、会话与重连

判断当前生命周期,理解自动重连与 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 和网络稳定性。连接成功但没有消息,继续检查订阅与发布权限,而不是不断点击重连。

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