单片机与物联网 / 系统课时

限制未确认 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,但仍需处理确认和其他控制报文。

Receive Maximum 使第三条 QoS 1 消息等待前两条确认的时序

用延迟确认复现两条窗口

准备一个支持 MQTT 5、监听本机 127.0.0.1:1883 的测试 Broker,并在 Python 环境安装 paho-mqtt 2.x。本例通过客户端 manual_ack=True 暂不发送 PUBACK,使用两条独立连接分别订阅和发布,避免把发布端收到 Broker 的 PUBACK 误当成订阅端已经确认。

保存为 receive_max_demo.py 后运行:

python
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 流控时):

text
收到: 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 这样的小窗口试压,再结合确认延迟、排队长度与吞吐调节;高时延链路窗口过小,往往会造成吞吐下降。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

限制未确认 QoS 消息数量

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通