3、MQTT协议详解：发布/订阅模型、主题、服务质量（QoS）、保留消息、遗嘱消息

3.2 主题（Topic）与通配符

主题是 MQTT 消息路由的核心寻址机制，采用 UTF-8 字符串，以正斜杠 / 作为层级分隔符。主题不需要提前在 Broker 上创建，发布者直接发布即可。设计良好的主题结构，能让订阅端用最少的通配符获取所需数据。

3.3 服务质量（QoS）——消息可达性保障

MQTT 提供三种 QoS 等级，用于控制消息在发布者与 Broker、Broker 与订阅者之间传输的可靠性。注意：QoS 是端到端逐跳的，发布时设置的 QoS 与订阅时设置的 QoS 会取两者中的最大值作为实际转发 QoS。

• QoS 0（至多一次）：消息直接发出，不等待确认，不重发。适用于传感器高频数据（如每 2 秒上报一次温度），丢失一帧影响不大。
• QoS 1（至少一次）：发送后等待 PUBACK 确认，超时未收到则重发。接收方可能收到重复消息，需要应用层做去重。
• QoS 2（恰好一次）：通过四步握手（PUBLISH → PUBREC → PUBREL → PUBCOMP）确保消息不重不漏。适用于控制指令、计费数据等关键场景。

// PubSubClient 中设置 QoS 示例
client.publish("sensor/temp", "25.5", true);   // 第三个参数 true 表示保留消息
client.subscribe("cmd/led", 1);                // 第二个参数 1 表示 QoS 1

3.4 保留消息（Retained Message）与遗嘱消息（LWT）

保留消息：发布者发布消息时若将 retain 标志置 1，Broker 会将该消息存储为主题的最新状态。当有新的订阅者订阅该主题时，Broker 会立即将这条保留消息推送给新订阅者，而不是等待下一次发布。这非常适合设备状态、配置参数等“需要立即获取当前值”的场景。

遗嘱消息（Last Will and Testament, LWT）：客户端在连接 Broker 时，可以预先设置一条遗嘱消息（包含主题和 payload）。如果客户端异常断开（如断电、网络中断、心跳超时），Broker 会自动代发这条遗嘱消息，通知其他订阅者该设备已离线。正常断开（发送 DISCONNECT）时不会触发遗嘱。

// PubSubClient 设置遗嘱消息示例
client.setWill("device/status", "offline", true);  // 遗嘱主题、内容、保留标志
client.connect("NodeMCU_01");                       // 连接成功后，若异常断开，Broker 自动发布遗嘱

3.5 案例：智能温控系统消息设计

假设你正在用 NodeMCU 制作一个智能温控面板，需要上报温度、接收控制指令、监控设备在线状态。合理的消息设计如下：

1. 温度上报：NodeMCU 每 5 秒发布 sensor/room1/temp，QoS 0，retain=false。数据格式为 JSON：{"temp":25.5,"hum":60}。
2. 控制指令：手机 App 发布 cmd/room1/ac，QoS 1，payload 为 {"power":"on","mode":"cool","set":24}。NodeMCU 订阅该主题并执行。
3. 设备状态：NodeMCU 连接时设置遗嘱 device/room1/status = offline，同时发布保留消息 online。这样 App 启动时能立即看到所有设备状态，设备掉线时也能及时感知。

// NodeMCU 端核心代码逻辑
void callback(char* topic, byte* payload, unsigned int length) {
  if (strcmp(topic, "cmd/room1/ac") == 0) {
    // 解析 JSON 并控制空调继电器
  }
}
void loop() {
  if (!client.connected()) reconnect();
  client.loop();
  static unsigned long lastPub = 0;
  if (millis() - lastPub > 5000) {
    float t = dht.readTemperature();
    char msg[50];
    snprintf(msg, 50, "{\"temp\":%.1f}", t);
    client.publish("sensor/room1/temp", msg);
    lastPub = millis();
  }
}

3.6 常见误区与复盘