Mosquitto 1.0.4 发布说明深度解析:poll 事件处理、QoS2 内存泄漏与客户端限速修复
后端消息队列消息路由【免费下载链接】mosquittoEclipse Mosquitto - An open source MQTT broker项目地址https://gitcode.com/gh_mirrors/mos/mosquitto点击查看免费下载导读本文以 Eclipse Mosquitto 官方发布的 1.0.42012-10-17版本公告为骨架结合当前仓库中的 ChangeLog.txt 与相关源码逐条还原该 bugfix 版本修复的三个问题broker 对poll()事件优先级处理的缺陷、libmosquitto 中 QoS2 消息的内存泄漏、Python 绑定模块的线程同步隐患以及mosquitto_pub -l逐行发布限速错误。读完本文你将理解 MQTT broker 底层事件驱动的关键细节、QoS2 四次握手的状态机以及客户端批量发布工具的内部实现。版本背景一次聚焦稳定性的 bugfix 发布1.0.4是 Mosquitto 1.0 系列中的一个维护性bugfix版本发布于 2012 年 10 月 17 日。与功能版本不同这类版本不引入新特性只针对已发现的问题进行修正。发布公告正文只有一句话——This is a bugfix release.——随后按Broker / Library / Clients三个模块列出了全部修复项这一分模块组织方式也沿袭到了今天的 ChangeLog.txt 中。版本公告与仓库中的 ChangeLog.txt 内容完全一致可互为印证。需要说明的是1.0.4 距今较久当前仓库源码已演进到更现代的架构因此下文在讲解修复原理时会以当前仓库中仍然可读的实现片段来说明这些问题的本质与解决思路。Broker正确处理poll()事件优先级避免误断开刚关闭连接的客户端问题描述公告原文指出broker 需要Deal with poll() POLLIN/POLLOUT before POLL[RD]HUP to correctly handle the case where a client sends data and immediately closes its socket.即在处理poll()返回的事件时必须先处理POLLIN可读/POLLOUT可写事件再处理POLLHUP/POLLRDHUP挂断事件否则当客户端发送数据后立即关闭 socket时broker 可能把本可正常读取的数据误判为连接异常而直接断开。底层原理poll()可能同时返回多种事件在 Linux 等平台上poll()对每个被监视的 socket 返回一组revents位掩码。关键点在于一个 socket 可以同时满足可读POLLIN和挂断POLLHUP/POLLRDHUP。典型场景是客户端发完最后一段数据立刻close()——此时内核缓冲区里还有数据可读但连接已经处于半关闭/挂断状态poll()会在同一次返回中同时置位POLLIN与POLLHUP。如果 broker 只检查挂断事件就立即断开连接那么这最后一批数据将被丢弃正确的做法是先把POLLIN上的数据读完再根据剩余状态决定是否断开。源码印证当前 mux_poll 实现的事件处理顺序当前仓库的 poll 复用器实现在 src/mux_poll.c。其中loop_handle_reads_writes()采用了两趟扫描的结构第一趟遍历所有上下文优先处理写事件POLLOUT与连接建立确认mosq_cs_connect_pending见 src/mux_poll.cif(pollfds[context-pollfd_index].revents POLLOUT || context-want_write || (context-ssl context-state mosq_cs_new)){ ... rc packet__write(context); }第二趟遍历所有上下文处理读事件POLLIN执行packet__read()等读取逻辑见 src/mux_poll.cif(pollfds[context-pollfd_index].revents POLLIN || ...){ do{ switch(context-transport){ case mosq_t_tcp: case mosq_t_ws: rc packet__read(context); break; ... } }while(SSL_DATA_PENDING(context)); }else{ if(context-pollfd_index 0 pollfds[context-pollfd_index].revents (POLLERR | POLLNVAL | POLLHUP)){ do_disconnect(context, MOSQ_ERR_CONN_LOST); continue; } }注意第二趟中的if / else结构只有当前没有POLLIN也没有 TLS 待读数据时才检查POLLERR | POLLNVAL | POLLHUP并执行do_disconnect(context, MOSQ_ERR_CONN_LOST)。这正是先处理可读数据、后处理挂断事件这一修复原则在当代代码中的延续——只要还有可读数据就不会因挂断标志而放弃读取。此外src/mux_poll.c 的mux_poll__add()展示了事件注册机制每个连接在pollfds数组中占据一个槽位按需在POLLIN与POLLIN | POLLOUT之间切换src/mux_poll.c并在删除连接时归还槽位。同一修复原则在 src/mux_epoll.c 与 src/mux_kqueue.c 中也有对应实现。为什么这很重要发送数据后立刻关闭是 MQTT 客户端非常常见的退出方式例如mosquitto_pub发完最后一条 QoS0 消息后随即断开。若 broker 在该场景下错误断开会导致最后一批数据包被内核丢弃QoS1/QoS2 消息握手不完整客户端收不到 PUBACK/PUBREC随后重连重发造成不必要的流量与延迟高并发下 broker 日志被大量虚假的CONN_LOST刷屏。Library修复 QoS2 消息的内存泄漏与 Python 模块线程同步问题修复一QoS2 消息内存泄漏bug #1064981公告原文Fix memory leak with messages of QoS2. Fixes bug #1064981.QoS2Exactly Once Delivery是 MQTT 语义最重的等级涉及 PUBLISH → PUBREC → PUBREL → PUBCOMP 四次报文交互。在旧实现中消息对象在等待握手完成的过程中若状态转移出错或连接中途重置消息节点可能既未被释放也未被重新入队从而泄漏内存。对长时间运行的订阅端来说高 QoS 流量下会持续累积。从当前仓库 lib/messages_mosq.c 可以看到 QoS2 的状态机已经相当严密发送方向的消息在释放到 in-flight 队列时QoS2 消息被置为mosq_ms_wait_for_pubrec状态等待 PUBREC见 lib/messages_mosq.c连接重连重置时message__reconnect_reset()对 QoS2 消息区分处理处于mosq_ms_wait_for_pubrec的回到mosq_ms_publish_qos2重发处于mosq_ms_wait_for_pubcomp的改为mosq_ms_resend_pubrel重发 PUBREL见 lib/messages_mosq.c接收方向mosq_md_in的 in-flight 队列中QoS2 消息因为状态应与对端一致而不会被简单清理见 lib/messages_mosq.c。正是这类重连后保留状态、握手完成前不释放的复杂路径容易在边界条件下漏掉message__cleanup()调用。1.0.4 修复的即是这类泄漏点而当前源码中每个状态转移都显式维护队列长度、配额与释放时机正是该修复长期演进的成果。修复二Python 模块传出数据包的线程同步bug #1064977公告原文Fix potential thread synchronisation problem with outgoing packets in the Python module. Fixes bug #1064977.libmosquitto 自带 Python 绑定mosquitto 包其回调线程与调用线程并发操作时传出outgoing数据包链表如果没有正确的锁保护会出现竞态条件——典型的症状是偶发丢包、崩溃或卡死。这类 bug 极难复现属于典型的潜在potential线程同步问题。1.0.4 通过为传出队列的读写补充同步原语修复了该问题。这一思路在当前仓库中体现为对消息队列的显式互斥锁管理例如 lib/messages_mosq.c 中对msgs_in/msgs_out队列统一使用COMPAT_pthread_mutex_lock()包裹遍历、删除与配额更新的关键区确保网络线程与用户线程并发访问消息链表时的一致性。Clients修复mosquitto_pub -l逐行发布被限速为每秒一条的问题问题描述公告原文Fixmosquitto_sub -lincorrectly only sending one message per second.这里涉及的-l--stdin-line模式其语义是从标准输入逐行读取文本每读入一行就作为一条独立消息发布到指定主题。1.0.4 之前该模式存在限速 bug——无论 stdin 中有多少行数据发布速率都被错误地限制为每秒一条。源码印证-l模式的参数解析与逐行发布实现在当前仓库中-l是mosquitto_pub的参数公告中写作 mosquitto_sub 系当时文档笔误实际为 pub 端读取 stdin 的发布模式。参数解析位于 client/client_shared.c}else if(!strcmp(argv[i], -l) || !strcmp(argv[i], --stdin-line)){ if(pub_or_sub ! CLIENT_PUB){ goto unknown_option; } if(cfg-pub_mode ! MSGMODE_NONE){ fprintf(stderr, Error: Only one type of message can be sent at once.\n\n); return 1; }else{ cfg-pub_mode MSGMODE_STDIN_LINE; } }可见它被归类为一种pub_modeMSGMODE_STDIN_LINE且与-m、-f、-n互斥。核心实现pub_stdin_line_loop()位于 client/pub_client.c使用fgets()从 stdin 逐行读取读到\n时去掉换行符后调用my_publish()立即发布行缓冲初始为 1024 字节line_buf_len 1024超长行通过realloc()自动扩容见 client/pub_client.c 与 client/pub_client.c每行之间没有人为延时逐行发布速率取决于 stdin 的供给速度与网络往返。bug 的成因与修复方向逐行发布最终也要跑在mosquitto_loop()上。在 1.0.4 之前-l模式沿用了普通发布循环的超时逻辑而该循环默认的loop_delay为 1000ms见 client/pub_client.c 中int loop_delay 1000;同时每次循环只尝试读取并发布一行于是实际效果被限速为每秒一条。修复方式即是让-l模式在事件循环的一次迭代内持续消费 stdin 中已有的全部行而不是每轮只发一条、再被 1 秒超时卡住。这与 client/pub_client.c 中pub_shared_loop()将MSGMODE_STDIN_LINE分流到独立循环的设计一致——逐行模式本就该走与普通单次发布不同的循环节奏。现代等价用法如今该功能仍是批量灌入测试消息的利器例如从文件逐行灌入 1 万条消息mosquitto_pub -h localhost -p 1883 -t test/topic -l messages.txt配合-q 2可验证 QoS2 逐条握手下的吞吐与内存稳定性——恰好与上文提到的 QoS2 泄漏修复形成完整闭环。小结Mosquitto 1.0.4 虽然只是一个小版本但它暴露的三类问题极具代表性模块修复内容对应现状仓库路径Brokerpoll()中先处理POLLIN/POLLOUT再处理挂断事件避免客户端发完即关时误断开src/mux_poll.cLibrary修复 QoS2 消息内存泄漏bug #1064981lib/messages_mosq.cLibrary修复 Python 模块传出数据包线程同步问题bug #1064977lib/messages_mosq.cClients修复-l逐行发布被错误限速为每秒一条client/pub_client.c、client/client_shared.c透过这四条修复可以看到 MQTT 基础设施开发中最容易踩坑的三个领域事件复用器的事件优先级语义、有状态协议QoS2 握手的资源生命周期管理、以及客户端工具在事件循环与数据供给之间的节奏匹配。无论是阅读 ChangeLog.txt 追踪历史还是直接研读当前src/mux_poll.c、lib/messages_mosq.c与client/pub_client.c的实现都能从中获得与编写高性能网络程序直接相关的经验。赞分享后端消息队列消息路由【免费下载链接】mosquittoEclipse Mosquitto - An open source MQTT broker项目地址https://gitcode.com/gh_mirrors/mos/mosquitto点击查看免费下载相关推荐Eclipse Mosquitto 1.6.12 发布详解QoS 2 消息内存泄漏修复与客户端退出码修正Eclipse Mosquitto 1.6.12 发布详解QoS 2 消息内存泄漏修复与客户端退出码修正 导读 本文围绕 Eclipse Mosquitto后端消息队列消息路由Mosquitto 1.4.10 发布说明深度解读Broker 持久化、TLS 与客户端库的关键修复Mosquitto 1.4.10 发布说明深度解读Broker 持久化、TLS 与客户端库的关键修复 Mosquitto 1.4.10 是 Eclipse M后端消息队列消息路由NumPy 2.3.2 补丁版本发布说明深度解析Python 3.14 支持、StringDType 与内存泄漏修复NumPy 2.3.2 补丁版本发布说明深度解析Python 3.14 支持、StringDType 与内存泄漏修复 本文以仓库内官方发布文档 doc/sou科学计算数据分析创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考