MQTT的QoS0、QoS1、QoS2有什么区别?
时间:2026-11-20 来源:华清远见
MQTT 是物联网最常用的协议之一。很多人对它的印象是“轻量级的发布订阅”,但真正把设备做稳定的团队,对 QoS 三个等级都有刻骨铭心的理解:消息丢了、重复了、恰好一次到底怎么保证,都是 QoS 的设计问题。本篇从原理出发,讲清三种 QoS 的语义、报文交互与适用场景,并用 mosquitto + paho-mqtt 做一个能亲眼看到“重复消息”的实操。
1 先回顾:MQTT 的发布订阅模型

图 5-1 发布订阅模型:Broker 按主题转发
MQTT 的所有通信都围绕“主题(Topic)”展开:发布者把消息发到某个主题,Broker 负责把主题匹配的消息转发给所有订阅者。发布者和订阅者互相不知道对方存在,Broker 是中间人。QoS(Quality of Service)定义的就是“发布者 → Broker → 订阅者”这条链路上,消息投递的可靠程度。
2 QoS 0:发完就不管,“最多一次”
QoS 0 的发布过程只有一问一答的一半:发布者发出 PUBLISH 报文后就当它消失了,Broker 不回复任何确认。语义上叫“最多一次(At most once)”——消息最多被投递一次,也可能零次(丢了就没了)。
适用场景:高频遥测数据,比如每秒上报的温度、GPS 坐标。丢一帧完全不影响大局,而每次确认的开销反而拖慢吞吐。QoS 0 的吞吐是三种里最高的,网络开销最小。
优点:零确认开销、延迟最低、吞吐最高;
缺点:网络抖动、Broker 重启、客户端掉线期间的消息全部丢失;
典型坑:以为“连上了就一直在收”,实际链路断了 5 秒,5 秒数据就没了。
3 QoS 1:至少一次,代价是可能重复
QoS 1 引入 PUBACK 确认:Broker 收到 PUBLISH 后返回 PUBACK,发布者收到 PUBACK 才算投递成功;如果发布者在超时时间内没收到 PUBACK,就会认为消息没送达而重发。这就保证了“至少一次(At least once)”——消息不会丢,但可能收到不止一次。

图 5-2 三种 QoS 的报文交互对比
重复发生的典型场景:网络丢包导致 PUBACK 丢失,发布者重发同一条消息;或者 Broker 已转发给订阅者但 PUBACK 丢了,Broker 侧重发。订阅者端收到两条一模一样的消息,业务层如果没有幂等处理,就会出现“一个订单下两遍”“一条告警弹两次”。

图 5-4 QoS1 重复消息与幂等化解
优点:可靠性好,适合命令下发、告警、计费类消息;
缺点:订阅方必须做幂等,这是很多人忽略的隐性成本;
实现要点:MQTT 3.1.1 中报文携带 PacketID,重发时 PacketID 不变,订阅端可以利用这一点做去重。
4 QoS 2:恰好一次,四段握手的代价
QoS 2 的目标是“恰好一次(Exactly once)”,在 MQTT 协议里它是靠四段握手实现的:

图 5-3 QoS 2 的四段握手与重发逻辑
▍QoS 2 四段握手
发布者 → Broker:PUBLISH (带 PacketID)
Broker → 发布者:PUBREC (确认收到)
发布者 → Broker:PUBREL (请投递)
Broker → 发布者:PUBCOMP (投递完成)
关键点在 PUBREL:它本身就是一个“确认的确认”。如果 PUBREL 丢失,发布者会重发 PUBLISH(相同的 PacketID),Broker 认得这个 PacketID,不会重复投递,只重新发 PUBREC——于是发布者再次发出 PUBREL,最终到达 PUBCOMP。整个过程中订阅者只会收到一次消息。
优点:理论语义上“恰好一次”,订阅方无需幂等;
缺点:四次报文交互、两个 RTT,延迟最高、吞吐最低;Broker 需要维护 PacketID 状态表,资源占用大;
适用:只允许一次的业务,如“开锁指令”“支付确认”,且业务方不打算在应用层做幂等时。
5 三种 QoS 对比

6 实操:用 mosquitto + paho-mqtt 亲眼看到“重复”
6.1 搭一个本地 Broker
▍mosquitto 安装与命令行自测

6.2 Python 演示:订阅 QoS1 + 发布,观察重发
▍paho-mqtt:订阅 QoS1 并观察重复

6.3 用幂等化解 QoS1 的重复
最稳妥的做法是在业务入口处做幂等,而不是指望 QoS:
▍幂等处理:按业务唯一键去重

7 常见 Bug 与重难点

8 小结
QoS0 最多一次:无确认、零开销,适合高频遥测,丢就丢了;
QoS1 至少一次:PUBACK 保证不丢,但必须接受重复,订阅方要做幂等;
QoS2 恰好一次:四段握手,语义最严谨但延迟最高、Broker 开销最大;
可靠性 ≠ 复杂度:能用 QoS1 + 幂等解决的事,不要引入 QoS2;
报文交互细节(PUBACK/PUBREC/PUBREL/PUBCOMP、PacketID)是排查重发/丢失问题的第一线索。

