单片机与物联网 / 系统课时
限制未确认 QoS 消息数量
限制未确认 QoS 消息数量
大量 QoS 1 消息流向处理缓慢的订阅者时,未确认数据会不断占用资源。本篇使用 MQTT 5 的 Receive Maximum 限制并行在途消息,并通过延迟 PUBACK 的实验观察 Broker 何时暂停、何时恢复发送。
学习目标
- 区分 CONNECT 和 CONNACK 中 Receive Maximum 各自约束的发送方向。
- 用 MQTT 5 客户端限制未确认的 QoS 1 消息数量并验证发送暂停。
- 判断窗口大小与吞吐、待发队列之间的关系。
确认限制的方向和范围
Receive Maximum 是接收方向公布的并发上限,合法值为 1~65535;属性缺失时默认 65535,填 0 属于协议错误。它只作用于当前网络连接,不是持久会话的消息保存条数。
- 客户端在 CONNECT 写入
Receive Maximum=2:Broker 向这个客户端发送的 QoS 1/2 PUBLISH,最多同时有两条处于未完成确认的发送窗口。 - Broker 在 CONNACK 返回该属性:限制客户端向 Broker 发送的 QoS 1/2 PUBLISH。若未返回,客户端按默认上限处理。
- QoS 0 不消耗该发送配额,因此这不是所有消息的统一速率限制。
发送端初始配额不得超过接收端公布的上限。以 QoS 1 为例,发送一条 PUBLISH 消耗一个配额,收到对应 PUBACK 才恢复一个;窗口耗尽时必须暂停新的 QoS 1/2 PUBLISH,但仍需处理确认和其他控制报文。

用延迟确认复现两条窗口
准备一个支持 MQTT 5、监听本机 127.0.0.1:1883 的测试 Broker,并在 Python 环境安装 paho-mqtt 2.x。本例通过客户端 manual_ack=True 暂不发送 PUBACK,使用两条独立连接分别订阅和发布,避免把发布端收到 Broker 的 PUBACK 误当成订阅端已经确认。
保存为 receive_max_demo.py 后运行:
import threading
import time
import paho.mqtt.client as mqtt
from paho.mqtt.packettypes import PacketTypes
from paho.mqtt.properties import Properties
HOST, PORT = "127.0.0.1", 1883
TOPIC = "demo/receive-max"
subscribed = threading.Event()
first_two = threading.Event()
third = threading.Event()
received = []
def on_connect(client, userdata, flags, reason_code, properties):
if not reason_code.is_failure:
client.subscribe(TOPIC, qos=1)
def on_subscribe(client, userdata, mid, reason_codes, properties):
if not reason_codes[0].is_failure:
subscribed.set()
def on_message(client, userdata, message):
received.append((message.mid, message.qos))
print("收到:", message.payload.decode(), flush=True)
# 前两条保留未确认状态,用于观察 Broker 的发送窗口。
if len(received) == 2:
first_two.set()
elif len(received) == 3:
client.ack(message.mid, message.qos)
third.set()
props = Properties(PacketTypes.CONNECT)
props.ReceiveMaximum = 2
subscriber = mqtt.Client(
mqtt.CallbackAPIVersion.VERSION2,
client_id="rxmax-sub", protocol=mqtt.MQTTv5,
manual_ack=True,
)
subscriber.on_connect = on_connect
subscriber.on_subscribe = on_subscribe
subscriber.on_message = on_message
subscriber.connect(HOST, PORT, properties=props)
subscriber.loop_start()
publisher = mqtt.Client(
mqtt.CallbackAPIVersion.VERSION2,
client_id="rxmax-pub", protocol=mqtt.MQTTv5,
)
try:
if not subscribed.wait(5):
raise TimeoutError("订阅没有建立")
publisher.connect(HOST, PORT)
publisher.loop_start()
for number in range(1, 4):
publisher.publish(TOPIC, str(number), qos=1).wait_for_publish()
if not first_two.wait(5):
raise TimeoutError("前两条消息没有到达")
time.sleep(1)
print("确认前第三条已到:", len(received) >= 3)
# 释放两个配额后,Broker 才能继续投递第三条。
for mid, qos in received[:2]:
subscriber.ack(mid, qos)
if not third.wait(5):
raise TimeoutError("释放配额后第三条仍未到达")
finally:
publisher.disconnect()
publisher.loop_stop()
subscriber.disconnect()
subscriber.loop_stop()预期输出(测试 Topic 没有其他生产者、Broker 正常实现 MQTT 5 流控时):
收到: 1
收到: 2
确认前第三条已到: False
收到: 3这个结果说明第三条消息并非丢失,而是在确认前留在 Broker 待发侧。若第三条提前到达,检查抓包中的 CONNECT 属性、实际协议版本以及是否真正延迟了订阅端 PUBACK。也可以抓取 Broker→订阅端的 PUBLISH 和反向 PUBACK,核对同一时刻未确认数量是否超过 2。
不要把并发窗口当成队列容量
对于 QoS 2,正常成功路径在收到 PUBCOMP 后才释放发送配额;收到表示失败的 PUBREC 时也可以释放。Receive Maximum 不规定 Broker 能排队多少消息,也不保证消息不丢失。大量积压仍需配合 Broker 的队列条数、队列字节数及会话过期策略限制。
例如 1000 条连接各允许 10 条未确认消息,平均每条负载 2 KiB,仅负载对应的潜在在途数据就约为 19.5 MiB,还未计算协议、索引和队列开销。初始可以从 10~20 这样的小窗口试压,再结合确认延迟、排队长度与吞吐调节;高时延链路窗口过小,往往会造成吞吐下降。