遗嘱消息是 MQTT 协议中一个非常实用的特性，它允许客户端在连接 Broker 时预设一条消息。当该客户端非正常断开连接时，Broker 会自动代其发布这条消息，通知其他订阅者“我出问题了”。这个机制就像现实生活中的遗嘱，在当事人无法亲自宣告时，由指定的人代为宣布。
🧭 遗嘱消息的核心概念
定义：遗嘱消息是客户端在建立连接时，通过
CONNECT报文携带给 Broker 的一条特殊消息（包含主题、QoS、保留标志和内容）。触发条件：Broker 检测到客户端异常断开（如网络中断、心跳超时、设备掉电、TCP 连接意外关闭），且客户端未发送
DISCONNECT报文。不触发条件：客户端主动发送
DISCONNECT报文正常断开，Broker 不会发布遗嘱消息。作用：用于状态监控、故障告警、资源释放等场景，让系统其他部分能及时感知设备离线。
⚙️ 遗嘱消息的设置
客户端在发送CONNECT报文时，可以在可变头中的连接标志（Connect Flags）里指定是否包含遗嘱消息，如果包含，则需要在有效载荷中提供以下信息：
| 遗嘱字段 | 说明 |
|---|---|
| Will Topic | 遗嘱消息要发布到的主题（例如device/offline）。 |
| Will Payload | 遗嘱消息的内容（例如{"status":"offline"}）。 |
| Will QoS | 发布遗嘱消息时使用的 QoS 等级（0、1、2）。 |
| Will Retain | 遗嘱消息是否作为保留消息（RETAIN标志）。若设为 1，Broker 会存储该遗嘱消息作为主题的最新保留消息。 |
一旦设置，遗嘱消息就与客户端的会话绑定，直到客户端正常断开或重新连接时修改。
🎬 遗嘱消息的触发过程
连接时注册：客户端 A 连接 Broker，并在
CONNECT报文中设置了遗嘱消息（主题notify/disconnect，内容offline，QoS 1）。正常运行：客户端 A 正常发布、订阅消息，Broker 维持连接。
异常断开：客户端 A 因网络故障突然掉线，Broker 在超时后检测到连接中断。
发布遗嘱：Broker 代客户端 A 向主题
notify/disconnect发布遗嘱消息（内容offline，QoS 1）。如果有客户端 B 订阅了该主题，就会收到这条离线通知。后续处理：遗嘱消息发布后，Broker 会将该客户端的所有状态（如果会话持久）标记为待清理，并根据会话过期设置决定是否保留。
💡 典型应用场景
设备在线状态跟踪
设备连接时发布一条保留消息online，并设置遗嘱消息offline（QoS 1，保留）。这样，任何订阅设备状态主题的客户端都能实时获取设备的在线状态（最新保留消息），并在设备离线时自动更新为offline。故障告警与通知
智能门锁异常离线时，Broker 发布遗嘱消息到告警主题，触发监控系统发送短信或推送通知。资源释放与清理
在分布式系统中，某个服务节点异常退出时，其遗嘱消息可通知负载均衡器将其从服务列表中移除，避免请求转发到失效节点。多设备联动
当网关设备掉线时，触发遗嘱消息，子设备收到后自动进入本地控制模式或尝试切换到备用网关。
⚠️ 注意事项与最佳实践
遗嘱消息的可靠性
遗嘱消息本身也是以某个 QoS 发布的。为确保重要通知能送达，建议设置 QoS 1 或 2。但需注意，遗嘱消息的发布不受发布者（已离线）的控制，完全依赖 Broker 与订阅者之间的传输。遗嘱消息与保留消息配合
将遗嘱消息的 Retain 标志设为 1 非常有用，这样新订阅者能立刻获取到设备当前状态（可能是offline）。但需注意，设备上线时应主动发布一条保留消息online，覆盖之前的offline状态。避免频繁触发
如果网络不稳定，客户端频繁重连，遗嘱消息可能被频繁触发。此时可考虑结合 MQTT 5.0 的Will Delay Interval（遗嘱延迟间隔），设置一个延迟时间（例如 30 秒），若客户端在延迟期间重连成功，则取消发布遗嘱，避免不必要的告警。遗嘱消息大小限制
遗嘱消息作为CONNECT报文的一部分，受报文总长度限制（通常 Broker 有最大报文大小限制）。建议保持遗嘱消息简洁，仅包含必要信息。遗嘱消息与持久会话
如果客户端设置了持久会话（Clean Session=0），即使异常断开，会话状态（包括遗嘱消息）依然保留。下次相同 Client ID 重连时，可以重新设置遗嘱消息覆盖旧的。安全性考虑
遗嘱消息发布到特定主题，可能泄露设备离线信息。应配置适当的 ACL（访问控制），只允许授权订阅者接收遗嘱主题的消息。
🆕 MQTT 5.0 对遗嘱的增强
MQTT 5.0 在遗嘱消息基础上增加了Will Delay Interval（遗嘱延迟间隔）属性：
客户端可以在
CONNECT报文中指定一个延迟时间（以秒为单位）。当客户端异常断开时，Broker 不会立即发布遗嘱，而是等待指定的延迟时间。
如果客户端在延迟期间重新连接成功（使用相同的 Client ID 和认证信息），Broker 会取消遗嘱发布。
这有效避免了因网络临时闪断导致的误报。
此外，MQTT 5.0 还允许在遗嘱消息中携带更多属性（如内容类型、格式指示符等），使遗嘱消息更灵活。
📌 总结
| 特性 | 描述 |
|---|---|
| 设置时机 | 客户端连接时（CONNECT 报文） |
| 触发时机 | 客户端异常断开（未发 DISCONNECT） |
| 包含内容 | 主题、QoS、保留标志、负载 |
| 主要作用 | 状态监控、故障通知、资源清理 |
| 关键注意事项 | 可靠性、与保留消息配合、避免误报 |
| MQTT 5.0 增强 | 遗嘱延迟间隔，避免网络闪断误触发 |
遗嘱消息是 MQTT 实现设备状态感知的重要手段，与保留消息、持久会话等特性结合，可以构建出健壮的物联网设备管理方案。在实际应用中，合理设置遗嘱消息的 QoS 和延迟，能有效提升系统的可靠性和用户体验。
