什么是遗嘱消息
遗嘱消息（Will Message / Last Will and Testament，LWT）是 MQTT 协议中的一个机制：客户端可以在 CONNECT 报文中预设一条“遗嘱”，包含目标 Topic、QoS、Payload 等信息。当 Broker 检测到该客户端非正常断开（如网络中断、未发送 DISCONNECT 报文等）时，就会将该遗嘱发布到预设的 Topic 上，通知其他订阅者该客户端已离线。
注意：客户端主动发送 DISCONNECT 报文正常下线时，不会触发遗嘱消息。
查看遗嘱消息
腾讯云 MQTT 控制台支持查看客户端的遗嘱消息详情，方便您排查客户端行为、验证遗嘱机制是否符合预期。
操作步骤
1. 登录 MQTT 控制台。在左侧导航栏单击 客户端管理 > 客户端列表，点击目标客户端 ID，进入客户端详情页。
2. 在“基本信息”Tab 下，找到遗嘱消息模块，可查看该客户端设置的所有遗嘱消息相关属性与消息体内容。
字段说明
字段 | 说明 |
Topic | 遗嘱消息发布的目标 Topic。 |
QoS | 遗嘱消息的服务质量等级。 |
是否保留消息 | 该遗嘱消息发布时是否携带 RETAIN 标志。 |
更新时间 | 该遗嘱消息最近一次被客户端更新的时间。 |
创建时间 | 该遗嘱消息的初始配置时间。 |
延迟发布时间 | 自定义扩展字段，指遗嘱消息从客户端断开到实际发布的延迟时间。在消息队列 MQTT 版中，Will 消息的实际发布延迟取 Will Delay Interval 与 Session Expiry Interval 中的较小值；若会话先于延迟到期而过期，Will 消息将立即发布。当客户端使用非 MQTT 5.0 协议时不会展示。 |
Response Topic | MQTT 5.0 属性。当客户端使用非 MQTT 5.0 协议时不会展示。 |
Correlation Data | MQTT 5.0 属性。当客户端使用非 MQTT 5.0 协议时不会展示。 |
User Property | MQTT 5.0 属性。当客户端使用非 MQTT 5.0 协议时不会展示。 |
Will Message Expiry Interval | MQTT 5.0 属性。当客户端使用非 MQTT 5.0 协议时不会展示。 |
内容类型 | MQTT 5.0 属性。当客户端使用非 MQTT 5.0 协议时不会展示。 |
Payload Format Indicator | MQTT 5.0 属性。标识 Payload 格式，如 UTF-8 。当客户端使用非 MQTT 5.0 协议时不会展示。 |
