背景

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

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

使用场景

火山引擎 消息队列 MQTT版 支持遗嘱消息

技术实现

MQTTx 构造客户端连接，并构造遗嘱消息

• MQTTx 客户端中编辑 客户端的遗嘱消息

验证并接收遗嘱消息

• 构造一个 MQTT 客户端订阅 vehicle/+/status 的遗嘱消息 topic
• 设备异常下线，获取到对应设备的遗嘱消息

注意事项

• 遗嘱消息必须在连接前设置，连接后无法修改
• 遗嘱依赖 MQTT KeepAlive 心跳机制，触发延迟取决于心跳间隔（通常 30–120 秒）
• 正常断开连接时不会触发遗嘱