单片机与物联网 / 系统课时
限制报文大小避免资源滥用
限制报文大小避免资源滥用
设备误将大段日志或图片放入单条 MQTT 消息时,Broker 可能承受额外内存压力。本篇设置 MQTT 5 的 Maximum Packet Size 和 Mosquitto 的负载上限,再用三种消息验证哪些能够投递、哪些会被拒收。
学习目标
- 区分整个 MQTT 控制报文大小与 PUBLISH 负载大小。
- 配置 Broker 的报文总字节上限和消息负载上限。
- 使用正常与超限消息验证限制是否生效。
先确认限制的是哪些字节
MQTT 5 的 Maximum Packet Size 是接收方在握手阶段公布的完整 MQTT 控制报文字节上限,包含固定报头、可变报头、属性和负载,不是 JSON 正文或文件内容的长度。属性值为正整数;0 属于协议错误,未携带属性则没有额外声明的报文大小限制,但仍受 MQTT 编码上限和实现限制约束。
- 客户端在 CONNECT 中声明该属性:限制 Broker 发给客户端的报文大小。
- Broker 在 CONNACK 中声明该属性:限制客户端发给 Broker 的报文大小。
- Broker 遇到超出自身已公布上限的入站报文时,按协议错误处理,MQTT 5 对应原因码为
0x95(Packet too large)。 - Broker 无法在客户端声明的上限内发送某条应用消息时,应丢弃对该客户端的超大投递,而不是截断消息内容。

在 Mosquitto 设置双层限制
以下使用 Eclipse Mosquitto 作为具体 Broker。创建 packet-limit.conf,配置一个只监听回环地址的测试监听器。max_packet_size 限制完整 MQTT 报文,message_size_limit 则是 Mosquitto 针对 PUBLISH 负载的额外限制;两者不是同一个参数。
listener 1884 127.0.0.1
allow_anonymous true
max_packet_size 1024
message_size_limit 512这份配置允许的 PUBLISH 既要满足整包不超过 1024 字节,又要满足负载不超过 512 字节。对 MQTT 5 客户端,Mosquitto 会通过 CONNACK 告知自身的最大报文接收限制。限制为 1024 字节时,512 字节的 Payload 也并不意味着报文只占 512 字节,因为 Topic、属性和报头还会占用空间。
启动并发送边界测试消息
准备已安装的 mosquitto、mosquitto_sub、mosquitto_pub 和 Python 3。先在终端 A 启动 Broker:
mosquitto -c packet-limit.conf -v预期结果:Broker 成功读取配置,监听 127.0.0.1:1884;日志中的启动时间与进程号取决于实际运行环境。如果端口被占用,先停止占用进程或修改监听端口。
在终端 B 启动订阅者,保持窗口运行:
mosquitto_sub -h 127.0.0.1 -p 1884 -V mqttv5 -t demo/size -v预期结果:订阅建立后进入等待状态,不会因没有消息而自动退出。
在终端 C 发布三条 QoS 1 消息,依次测试正常负载、仅超出负载限制、以及超出整包限制:
mosquitto_pub -h 127.0.0.1 -p 1884 -V mqttv5 -q 1 -t demo/size -m ok
mosquitto_pub -h 127.0.0.1 -p 1884 -V mqttv5 -q 1 -t demo/size -m "$(python3 -c 'print("x" * 600)')"
mosquitto_pub -h 127.0.0.1 -p 1884 -V mqttv5 -q 1 -t demo/size -m "$(python3 -c 'print("x" * 2000)')"预期结果:终端 B 只出现正常投递的消息:
demo/size ok600 字节负载的整包小于 1024 字节,却超过 message_size_limit 512,因此不会转发给订阅者;其 QoS 1 确认可能携带实现特定错误原因码。2000 字节负载超过整包上限,符合 MQTT 5 的客户端应根据 CONNACK 限制避免发送;若违规发送,Broker 可以断开连接。具体发布工具的错误文字和退出码可能随版本变化,不应以某一条固定日志作为唯一验收条件。
生产配置还需控制积压
最大报文大小只控制单包上限,不能限制连接总数、发送频率或离线会话队列。选择阈值时,先测量业务消息的 P95/P99 大小和最大 Topic、属性开销,再给正常峰值留余量;遥测若通常小于 1 KiB,可以先用数 KiB 的总包阈值进行压测,而不要直接套用实验用的 1024 字节。
大文件、固件和照片更适合通过对象存储或 HTTP 上传,在 MQTT 中仅传文件标识、下载地址或任务状态。遇到正常消息被拒,先区分是 Payload 超出 message_size_limit,还是完整 Packet 超出 max_packet_size;前者通常不转发,后者可能触发 0x95 或本地发送拒绝。