文档中心

云原生消息引擎

最佳实践

遗嘱消息获取设备异常下线

在车联网（IoV）、物联网（IoT）等系统中，设备（如车辆终端、传感器）与云端平台通过 MQTT 协议保持长连接。当设备由于网络故障、断电、程序崩溃等原因导致非正常下线时，平台往往无法立即感知，影响了在线状态管理、告警推送及业务处理的及时性和可靠性。

为了解决这一问题，MQTT 协议提供了遗嘱消息（Last Will and Testament, LWT）机制。当客户端意外断开连接，Broker 会自动将客户端事先声明的“遗嘱消息”发布到指定的主题，从而通知其他系统组件设备已经异常下线。该机制可以极大的帮助业务识别异常下线的车辆和物联网设备，进而进行后续的处理。

火山引擎云原生消息引擎 MQTT 版支持遗嘱消息。

使用场景

场景	说明
车载终端突然断电	平台无法收到下线通知，可通过 LWT 感知
设备网络中断掉线	网络质量不稳定，造成隐性离线
应用崩溃或死机	程序未执行正常断开逻辑
动态离线告警	用于及时触发平台侧告警、设备状态变更、数据清理等操作

注意事项

遗嘱消息必须在连接前设置，连接后无法修改。

遗嘱依赖 MQTT KeepAlive 心跳机制，触发延迟取决于心跳间隔（通常 30~120 秒）。

正常断开连接时不会触发遗嘱。

准备工作

安装MQTT 客户端工具 MQTTX，参考 MQTTX 官方安装文档。

操作步骤

在 MQTTX 客户端中构造客户端连接，并构造遗嘱消息。

在MQTTX 客户端中编辑客户端的遗嘱消息。

验证并接收遗嘱消息。

构造一个 MQTT 客户端订阅 vehicle/+/status 的遗嘱消息 Topic。

设备异常下线，获取到对应设备的遗嘱消息。

最近更新时间：2025.08.04 17:30:06

这个页面对您有帮助吗？

有用

无用