Mosquitto 0.9 发布解析：移除 SQLite 依赖、IPv6 与 MQTT v3.1 认证支持

本文基于 Eclipse Mosquitto 仓库中的 0.9 版本发布公告（version-0-9-released.md）展开，逐条解读这一"特性发布"（features release）中最重要的架构级变化——存储层从 SQLite 迁往自定义内存数据结构、配置系统由 interface 演进为 listener/bind_address、MQTT v3.1 用户名密码认证支持，以及若干 QoS 2 协议合规性修复。读完本文，你将理解 0.9 版本为 Mosquitto 后续架构打下的基础，并能结合当前仓库源码（src/conf.c、src/database.c、mosquitto.conf 等）验证这些设计决策的落地方式。

一、版本背景：一次里程碑式的架构调整

0.9 是 Mosquitto 发布史上"最具意义的变化"之一。它的核心动作是移除 SQLite 依赖，同时一并去掉与其配套的 pcre 与 sqlite3-pcre 依赖。这一调整带来两个直接收益：

• 每秒消息处理能力（throughput）提升：不再经由 SQLite 的磁盘 I/O 与查询开销；
• 内存占用下降：客户端与消息数据改为由自定义例程（custom routines）在内存中直接管理。

随之而来的一个重要副产品是持久化数据库格式的重新实现——从 SQLite 格式迁移为 Mosquitto 自定义的二进制格式。为了让存量用户平滑升级，0.9 提供了可选的旧 SQLite 数据库导入支持，且该选项在 0.9 中默认编译启用。公告同时明确了时间表：该导入能力将在 0.10 中改为默认不编译，并在 0.11 中彻底移除。也就是说，0.9 是用户从 SQLite 时代迁移到自定义持久化格式的"最后窗口期"。

二、MQTT v3.1 支持：用户名 / 密码认证

0.9 紧随当时刚更新的 MQTT v3.1 规范，最大亮点是引入了用户名 / 密码认证支持：

• 客户端与客户端库（libmosquitto）具备完整的 v3.1 支持，即客户端可以在 CONNECT 报文中携带 username/password 字段；
• Broker 层面完全兼容 v3.1——它能够正确解析连接中的用户名与密码标志位，但在 0.9 阶段"不会对用户名和密码做任何实际处理"（即尚未实现校验逻辑）。真正的访问控制机制被安排在 0.10 中落地。

也就是说，0.9 打通了"客户端发起认证请求、broker 接收并理解认证字段"的整条链路，但认证策略（密码文件校验、ACL 等）留待下一版本。

三、IPv6 支持与兼容 IBM rsmb 的目标

公告明确了 Mosquitto 的两层目标：

1. 成为 IBM rsmb broker 的 drop-in 替代品；
2. 做得比 rsmb 更多。

0.9 在第二点上取得了实质进展：为 broker 与客户端同时加入 IPv6 支持——这是 rsmb 不具备的能力。对双栈网络的部署而言，这意味着 Mosquitto 可以直接监听 IPv6 地址，而无须依赖额外的 IPv4 转换网关。

在今天的源码中，IPv6 相关的监听行为仍可从 mosquitto.conf 中看到脉络：配置注释明确说明"默认情况下监听器会尝试监听所有受支持的 IP 协议版本"，并提供了 socket_domain 选项用于强制仅使用 IPv4（ipv4）或仅使用 IPv6（ipv6），如需双栈则不要设置该选项。

四、配置系统的重构：interface → listener 与 bind_address

0.9 对配置体系做了一次重要演进：

• 移除 mosquitto 命令行选项 -i interface；
• 移除 mosquitto.conf 中的 interface 变量；
• 新增 listener 配置变量（取代 interface）；
• 新增 bind_address 配置变量；
• port 变量行为向 rsmb 对齐：只作用于默认监听器，且只能出现一次。

这套设计在今天的 src/conf.c 中仍能看到清晰的实现痕迹：解析器遇到 listener 关键字后会读取端口号（tmp_int，合法范围 1~65535，且支持 Unix Socket 场景下端口为 0），随后通过 strtok_r 读取可选的绑定地址（IP/主机名或 Unix socket 路径），并调用 config__add_listener 将其追加进监听器列表。这印证了"一个 listener 行 = 一个监听端口/地址组合"的语义，也因此支持在一个配置文件中通过多次声明 listener 来监听多个端口。

对应的 bind_address 解析位于 src/conf.c，它被解析进 config->default_listener->host，并会经过 conf__attempt_resolve 做解析校验。

现代 mosquitto.conf 中的注释也延续了这一设计语言：

# listener port-number [ip address/host name/unix socket path]
#listener

并补充说明：若使用了 listener 且未给出 bind_address 或 port，则默认监听器不会启动；bind_address 的语义是把监听器绑定到指定地址以将访问限制在对应网络与接口上，默认情况下 Mosquitto 监听所有接口。

五、QoS 2 协议合规性修复

0.9 修复了多个直接影响 MQTT 协议正确性的缺陷，其中 QoS 2 相关修复被公告特别点名（对应 bug #598290）：

• 修复 QoS 2 协议合规性：停止发送重复消息（duplicate messages），并正确处理超时（timeouts）；
• DUP 位修正：重发 PUBREL 消息时正确设置 DUP 位。

此外还有一批协议层面的细节修复：

• retain 标志只应在响应 SUBSCRIBE 而发送的"陈旧数据"（stale data）消息上设置，纠正了出站消息 retain 标志设置不当的问题；
• 修复 on_connect 客户端回调返回错误 CONNACK 结果的问题；
• 客户端超过 keepalive 定时器被断开时，不再发送其遗嘱消息（will）；
• 修复客户端库 unsubscribe 函数误发 SUBSCRIBE 命令而非 UNSUBSCRIBE 的 bug。

这些修复共同提升了 Mosquitto 与 MQTT 规范的对齐程度，特别是 QoS 2 的四步握手（PUBLISH→PUBREC→PUBREL→PUBCOMP）在丢包与重传场景下的行为。

六、max_inflight_messages 与 max_queued_messages 语义修正

0.9 明确了两个流控参数的语义：

• 这两个参数现在只对 QoS 1 和 QoS 2 消息生效；
• 无论客户端处于连接还是断开状态，参数都会被使用（此前仅在特定连接状态下生效）。

在今天的源码中，这两个参数的行为依然可验证：

• 默认值定义在 src/conf.c：max_inflight_messages = 20、max_queued_messages = 1000；
• 配置解析处（src/conf.c）对 max_inflight_messages 校验其值必须 <= 65535（因其最终被转换为 uint16_t）；
• src/context.c 在创建客户端上下文时，用 max_inflight_messages 初始化入站/出站双向的 inflight_maximum 与 inflight_quota；
• src/database.c 与 src/handle_publish.c 则在队列写入路径上以 max_queued_messages 作为消息数上限进行判定。

七、存储与持久化细节

与存储层重构配套的细节包括：

• 客户端与消息数据改用自定义例程管理的内存数据结构，不再依赖 sqlite 数据库；
• 持久化数据库格式被重写为自定义格式，同时提供可选的旧 sqlite 数据库导入；
• 提供编译期选项，用 32 位整数替代 64 位整数作为数据库 ID。这对于没有 htobe64()/be64toh() 的环境（例如部分嵌入式系统）非常有用。

八、其他变更与发布配套信息

公告还包含若干工程与发布层面的变更：

• mosquitto.conf 安装位置变更：从 /etc/mosquitto.conf 改为 /etc/mosquitto/mosquitto.conf。/etc/mosquitto/ 目录未来将用于存放密码文件与访问控制文件；
• Windows 原生移植初步完成：不过当前版本会缺失部分功能，包括无法修改配置参数以及不支持持久化存储；
• Python 绑定包改名：Debian/Ubuntu 用户需要注意，包 libmosquitto0-python 已更名为 python-mosquitto，以符合 Debian 命名规范（0.9 发布时 Debian 包尚未就绪）；
• 完整更新请查阅发布公告原文 version-0-9-released.md。

九、总结

0.9 版本的意义不在于新增了多少功能点，而在于它为 Mosquitto 后续版本确立了三大技术方向：

方向	0.9 落地内容	后续演进（据公告/源码推断）
去 SQLite 化	自定义内存存储 + 自定义持久化格式 + 可选导入	0.10 默认关闭导入，0.11 移除
认证体系	客户端完整 v3.1 认证字段；broker 解析但不校验	0.10 提供用户名/密码控制机制
配置模型	listener/bind_address 取代 interface	延续至今的多监听器架构

从当前仓库源码看，listener 解析、bind_address 绑定、max_inflight_messages/max_queued_messages 流控等 0.9 引入的设计，至今仍是 src/conf.c、src/context.c、src/database.c 与 mosquitto.conf 中的核心组成部分。这也解释了为何发布公告称其为"迄今为止对 Mosquitto 最具意义的变化"——它奠定了该项目此后十余年架构演进的基石。