7.9 KiB
tags, create time
| tags | create time | ||||
|---|---|---|---|---|---|
|
2026-05-24 19:52 |
MQTT 协议
概述
MQTT（Message Queuing Telemetry Transport）是专为物联网（IoT）场景设计的轻量级消息协议。它的设计哲学极其明确：在低带宽、高延迟、不可靠的网络环境下，用最小的资源开销实现设备间的消息传递。从智能家居传感器到工业 SCADA 系统，MQTT 已经成为 IoT 通信的事实标准。
正文
为什么需要 MQTT？
想象一个场景：成千上万个温度传感器部署在偏远地区，它们通过 2G/3G 网络上报数据。这些设备 CPU 弱、内存小、电量有限、网络时断时续。在这种约束下，HTTP 的冗长头部和请求-响应模型就成了灾难。MQTT 就是为解决这类问题而生的——它把协议开销压缩到极致（最小报文仅 2 字节），支持持久连接，提供灵活的消息可靠性保障。
报文结构
MQTT 的每条报文由三部分组成：
+------------------+--------------------+----------+
| Fixed Header | Variable Header | Payload |
+------------------+--------------------+----------+
- Fixed Header（必选）：包含报文类型（4 bit）、标志位（4 bit）和剩余长度（可变字节编码）。报文类型定义了 14 种操作，如 CONNECT、PUBLISH、SUBSCRIBE 等。
- Variable Header（可选）：根据报文类型不同而变化，比如 PUBLISH 报文里放 Topic 名称，CONNECT 报文里放协议版本和连接标志。
- Payload（可选）：实际消息内容。CONNECT 报文的 Payload 是 Client ID 和遗嘱消息，PUBLISH 报文的 Payload 就是应用数据。
[!question] 为什么 Fixed Header 的"剩余长度"要用可变字节编码（Variable Byte Encoding）？ 因为 IoT 场景下大部分消息体很小（几十字节），如果用固定 4 字节表示长度就太浪费了。可变编码让 0-127 字节的长度只占 1 字节，128-16383 字节占 2 字节，以此类推——小消息用小开销，大消息也能表示。
QoS 等级：三种可靠性语义
MQTT 最精妙的设计之一就是三个 QoS（Quality of Service）等级，让发布者按需选择投递保证，而不是"一刀切"。
QoS 0 - 最多一次（At Most Once）
fire-and-forget，发送即忘。没有确认机制，消息可能丢失。适合传感器周期性上报——丢一帧温度数据无所谓，下一帧马上就来。
QoS 1 - 至少一次（At Least Once）
发布者收到 PUBACK 后才确认发送完成。如果超时未收到 ACK，会重发消息（DUP 标志置 1）。这意味着消息不会丢，但可能重复投递——消费者需要自行处理幂等。
QoS 2 - 恰好一次（Exactly Once）
通过四次握手保证消息恰好送达一次，是最高等级但也最重的语义。
sequenceDiagram
participant P as "Publisher"
participant B as "Broker"
participant C as "Consumer"
Note over P,B: "QoS 0: fire and forget"
P->>B: "PUBLISH QoS 0"
B->>C: "PUBLISH QoS 0"
Note over P,B: "QoS 1: at least once"
P->>B: "PUBLISH QoS 1"
B-->>P: "PUBACK"
B->>C: "PUBLISH QoS 1"
C-->>B: "PUBACK"
Note over P,B: "QoS 2: exactly once"
P->>B: "PUBLISH QoS 2"
B-->>P: "PUBREC"
P->>B: "PUBREL"
B-->>P: "PUBCOMP"
B->>C: "PUBLISH QoS 2"
C-->>B: "PUBREC"
B->>C: "PUBREL"
C-->>B: "PUBCOMP"
[!question] QoS 2 的四次握手会不会很慢？在什么场景下值得用？ 相比 QoS 0/1，QoS 2 确实多了额外的往返开销。但在需要精确计数的场景下（如扣费指令、库存变更、IoT 设备的命令下发），一条消息重复执行可能导致严重后果。实际部署中，很多系统选择 QoS 1 + 消费端幂等的组合来平衡性能和可靠性，只在真正"不能重复"的关键路径上才用 QoS 2。
核心概念
Topic 与通配符
MQTT 使用层级结构的 Topic 进行消息路由，用 / 分隔层级，例如 home/livingroom/temperature。
订阅时支持两种通配符：
+：匹配单个层级。home/+/temperature匹配home/livingroom/temperature和home/bedroom/temperature。#：匹配多个层级（必须放在末尾）。home/#匹配home/下所有 Topic。
遗嘱消息（Will Message）
客户端在连接时可以设置一条"遗嘱消息"。如果客户端异常断线（没有发送 DISCONNECT），Broker 会自动将这条遗嘱消息发布到指定 Topic。这对 IoT 设备的在线状态监控非常有用——订阅遗嘱 Topic 就能实时知道哪些设备掉线了。
保留消息（Retain）
当 PUBLISH 报文的 Retain 标志置 1 时，Broker 会保存这条消息。后续任何新订阅该 Topic 的客户端会立即收到这条保留消息，而不是等到下一次发布。典型场景：传感器发布当前温度为保留消息，新上线的监控端一订阅就能拿到最新值，不用等下一次上报。
Clean Session
- Clean Session = 1：每次连接都是全新会话，Broker 不保留任何订阅关系和未确认消息。适合无状态客户端。
- Clean Session = 0：Broker 为客户端持久化会话（订阅列表 + QoS 1/2 的未确认消息）。客户端断线重连后能恢复之前的订阅并收到离线期间的消息。
MQTT 5.0 新特性
MQTT 5.0（2019 年发布）是一次重大升级，引入了多项企业级特性：
- 共享订阅（Shared Subscriptions）：多个客户端组成一个订阅组，消息在组内负载均衡分发。这解决了 MQTT 之前缺乏 Consumer Group 的痛点，类似 Kafka 的分区分配。
- 用户属性（User Properties）：在报文头部附加自定义键值对，可用于传递链路追踪 ID、业务上下文等元信息，而不用修改消息体。
- 原因码（Reason Codes）：所有响应报文都携带结构化的原因码，取代了之前模糊的返回码，方便客户端精确处理错误（如"Topic 名称不合法" vs "鉴权失败"）。
- Session Expiry Interval：可以设置会话过期时间，不再只有"立即过期"和"永不过期"两种选择。
- 请求-响应模式：引入 Response Topic 和 Correlation Data 属性，让 MQTT 原生支持请求-响应模式。
Go 代码示例
使用 Eclipse Paho MQTT Go 客户端实现消息的发布和订阅。
package main
import (
"fmt"
"time"
mqtt "github.com/eclipse/paho.mqtt.golang"
)
func main() {
// 创建客户端选项
opts := mqtt.NewClientOptions().
AddBroker("tcp://localhost:1883").
SetClientID("go-mqtt-demo").
SetCleanSession(true)
// 设置连接成功后的订阅回调
opts.OnConnect = func(c mqtt.Client) {
// 订阅 Topic，QoS 1
c.Subscribe("sensor/temperature", 1, func(_ mqtt.Client, msg mqtt.Message) {
fmt.Printf("收到消息: topic=%s payload=%s\n", msg.Topic(), string(msg.Payload()))
})
}
client := mqtt.NewClient(opts)
if token := client.Connect(); token.Wait() && token.Error() != nil {
panic(token.Error())
}
// 发布消息，QoS 1，Retain 标志设为 false
token := client.Publish("sensor/temperature", 1, false, "23.5°C")
token.Wait()
time.Sleep(time.Second)
client.Disconnect(250)
}
这段代码做了三件事：连接 Broker、订阅 sensor/temperature Topic、发布一条温度消息。OnConnect 回调确保断线重连后会重新订阅，这是 MQTT 客户端开发的最佳实践。
[!tip] 实践建议
- IoT 设备资源紧张时优先用 QoS 0，需要可靠投递用 QoS 1，关键控制指令才用 QoS 2。
- 生产环境务必启用 TLS 加密。MQTT 默认端口 1883 是明文的，安全端口是 8883。
- Client ID 必须全局唯一，否则会踢掉前一个同 ID 的连接。