dbx MQTT 客户端问题修复实战JSON 发布面板、Topic 持久化、TLS 证书登录与 No Local 消息分流【免费下载链接】dbx25 MB lightweight cross-platform database client for 90 databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90 数据库提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。项目地址: https://gitcode.com/gh_mirrors/dbx7/dbx本文是 dbx 开源仓库中 MQTT Issues 修复计划 的展开解读与源码级分析。dbx 内置的 MQTT 管理控制台承担着 broker 连接、Topic 订阅/发布、消息查看等职责而这份修复计划针对社区反馈的 5 个真实问题发布面板崩溃、Topic 丢失、缺少 TLS 证书登录、订阅回送副本、消息方向无法区分给出了从根因定位到验收标准的完整方案。读完本文你将理解每个问题背后的技术根因Vue I18n 插值、进程内存态、Rustls 握手、MQTT 5 订阅选项等并掌握与仓库实现一一对应的修复路径与验证方法。问题清单与优先级划分修复计划围绕 5 个关联 issue 展开按影响程度分为 P0阻断性缺陷与 P1体验性缺陷编号优先级问题描述关联能力#5471P0JSON 发布面板消失重新打开后 Topic 丢失发布面板渲染#5490P0断线后 Topic 丢失缺少 SSL 证书登录订阅持久化 TLS#5450P0Payload 切换为 JSON 后发送框消失发布面板渲染#5448P1禁止 MQTT 本地转发、消息分区展示No Local 消息方向#5456P1保存 Topic 配置订阅持久化其中三个 P0 直接导致核心发布功能不可用或数据丢失因此修复计划将发布面板稳定性与订阅配置持久化放在最优先的位置。现状与根因四条问题链的源码印证根因 1JSON placeholder 中的花括号被 Vue I18n 当作插值表达式发布面板的输入提示是根据编码格式动态切换的。在 MqttPublishDialog.vue 中JSON 编码的占位符通过 i18n 消息渲染case json: return t(connection.mqttPayloadPlaceholderJson, { example: {key: value} });问题在于如果语言包中直接硬编码了原始 JSON 示例文本包含未转义的{...}花括号Vue I18n 会把这些花括号当作插值表达式编译导致模板解析异常进而使整个发布组件渲染失败——这就是选择 JSON 后发布面板消失、发送框消失的直接原因。修复方向是改为安全参数插值把示例 JSON 通过 i18n 的命名参数传入如上面代码中{ example: {key: value} }语言包里只保留{example}占位符避免未转义花括号进入语言包源码。根因 2Topic 只存在于客户端进程内存MQTT Topic 在修复前只保存在MqttClient的进程内存中。从 client.rs 可以看到客户端内部维护了三套订阅集合subscriptions当前 broker 已通过 ACK 确认的 topic 集合granted_subscriptionsbroker 最近一次实际授予的 QoS用于恢复持久会话显示desired_subscriptions需要在无会话重连后恢复的 topic 集合。这套设计能覆盖同一客户端网络重连的场景——事件循环收到 CONNACK 后若session_present为 false会调用restore_desired_subscriptionsclient.rs重新发起订阅。但一旦重建客户端或重启应用这些内存状态全部丢失因为没有任何持久化载体。修复计划给出的答案是把订阅配置写入连接配置并落盘。根因 3证书认证类型声明与实现脱节在类型层面mqtt.rs 中MqttAuth早已声明了Certificate变体包含caCertPath、clientCertPath、clientKeyPath三个可选字段前端 mqtt.ts 也同步定义了kind: none | password | certificate。但实际存在两处脱节连接 UI 只提供无认证和账号密码两种虽然 ConnectionDialog.vue 已经定义了mqttAuthKind与证书路径字段但证书认证的完整交互选择与校验 CA、客户端证书、客户端私钥需要补齐Rust TLS 构建只应用账号密码在 client.rs 中apply_credentials_v4/v5只处理MqttAuth::Password分支Certificate分支不会进入 TLS 配置。根因 4消息有方向字段但订阅缺 No Local 选项消息结构体MqttMessage已经携带direction字段sent/received见 mqtt.rs。发布路径中客户端在 client.rs 构造消息时显式标记direction: MqttMessageDirection::Sent收到的消息则标记为Received。问题在于订阅请求没有 MQTT 5 的 No Local 选项。MQTT 5.0 规范规定如果订阅设置了 No Localbroker 不会把客户端自己发布的消息回送给该客户端。缺少这个选项时客户端发布到自己订阅的 Topic会看到 broker 回送的自己发出去的副本消息列表里出现重复且难以区分的内容。实施顺序与源码级修复方案1. P0JSON 发布面板稳定性三个动作缺一不可JSON 示例改为安全参数插值即根因 1 中的方案语言包只保留{example}命名参数保持 Payload textarea 和发布按钮在编码切换后继续挂载MqttPublishDialog.vue中 textarea 与按钮是平级静态节点模板结构编码切换只更新encodingref 与占位符不应触发组件重建增加切换所有 Payload 编码的组件回归测试并覆盖非法 JSON。关于非法 JSON 的兜底前端编解码工具 mqttPayloadCodec.ts 的encodePayload是天然校验点JSON 分支先执行JSON.parse(input)再重新序列化任何语法错误都会抛出编码失败 (JSON): ...异常发布流程捕获后写入error状态并展示MqttPublishDialog.vue。该模块共支持六种编码plaintext、json、base64、hex、cbor、msgpack其中 CBOR/MsgPack 同样以 JSON 文本作为输入再序列化为二进制。2. P0/P1Topic 持久化这是修复计划中设计最完整的一块仓库源码已经落地了对应结构配置层MqttConnectionConfig新增saved_topics: VecMqttSavedTopic字段mqtt.rs序列化名savedTopics并通过#[serde(default, skip_serializing_if Vec::is_empty)]保证旧连接配置没有该字段也能正常解析实现向后兼容。单个订阅条目MqttSavedTopicmqtt.rs包含字段类型说明topicstring订阅过滤器qosMqttQoS默认atmostoncenoLocalbool是否启用 MQTT 5 No Localenabledbool是否在连接时自动恢复订阅旧配置缺失时按true处理状态层客户端新增saved_topic_configs含禁用条目与no_local_topics两个集合client.rs。客户端创建时new_with_backendclient.rs直接从config.saved_topics初始化desired_subscriptions与no_local_topics只取enabled的条目。订阅/取消订阅联动订阅成功收到 SUBACK后complete_subscribe_ackclient.rs会把 topic 的 qos、noLocal、enabled 更新或追加进saved_topic_configs取消订阅成功收到 UNSUBACK后complete_unsubscribe_ackclient.rs不会物理删除条目而是把enabled置为false保留配置便于用户重新启用同时提供了两个直接操作配置的接口save_topic_configclient.rs与delete_topic_configclient.rs前者按 topic 合并更新后者在用户显式删除时移除条目。前端 api.ts 已暴露mqttSaveTopicConfig、mqttDeleteTopicConfig、mqttListSavedTopicConfigs三个命令。恢复流程保留原有网络重连恢复逻辑restore_desired_subscriptions同时在客户端创建与首次 CONNACK 后恢复保存的订阅。handle_connackclient.rs判断session_present如果 broker 保留了持久会话直接恢复granted_subscriptions否则清空当前订阅并异步执行restore_desired_subscriptions。合并更新计划要求使用按连接 ID 的合并更新避免覆盖用户同时修改的其他连接字段。这意味着前端在保存连接配置时只把savedTopics数组合并回原external_config而不是整体替换 MQTT 配置对象从而保护用户在同一会话中修改的其他字段。3. P0TLS 与证书登录UI 层增加 CA 证书、客户端证书、客户端私钥的选择与校验。前端连接表单的mqttAuthKind已支持certificate分支ConnectionDialog.vue回填caCertPath、clientCertPath、clientKeyPath提交时构造{ kind: certificate, caCertPath, clientCertPath, clientKeyPath }第 1477-1479 行。校验规则与后端一致证书认证必须启用 TLS且三个路径的完整性需要校验。Rust 层build_transportclient.rs根据tls_verification_modeVerifyServerCert/SkipServerCertVerification源自tls与tlsSkipVerify的组合和认证方式选择传输certificate_tls_configurationclient.rs负责构建 mTLS 配置其内部逻辑值得细读CA 处理若配置了caCertPath用rustls_pemfile::certs解析并加入RootCertStore未配置则回退到webpki_roots::TLS_SERVER_ROOTS系统根证书之外的内置 WebPKI 根校验模式VerifyServerCert使用标准with_root_certificatesSkipServerCertVerification通过自定义的NoCertificateVerification校验器跳过服务端证书验证client.rs它只校验 TLS 1.2/1.3 签名算法不对证书链做任何信任判断mTLS 客户端认证客户端证书与私钥必须成对出现缺任一都会报错缺少客户端证书路径/私钥路径两路都提供时调用with_client_auth_cert(certs, key)传输映射TCP 走Transport::tls_with_configWebSocket 走Transport::wss_with_config。另有verified_tls_configuration系统 WebPKI 根 无客户端认证与insecure_tls_configuration跳过验证 无客户端认证供非证书场景复用。安全约束只保存证书路径绝不把私钥内容写入连接配置——MqttAuth::Certificate的三个字段都是OptionString路径而非内容这一点在 mqtt.rs 的类型定义层面就保证了。配置校验from_connectionmqtt.rs还会拒绝证书认证但未启用 TLS的组合。4. P1No Local 与消息分流协议层MqttBackendClient::subscribeclient.rs按协议版本分流MQTT 5构造MqttV5Filter后显式设置filter.nolocal no_local再通过subscribe_many发送MQTT 3.x直接返回错误MQTT 3.x 不支持 No Local 订阅选项。同样的约束也出现在MqttClient::subscribeclient.rs与save_topic_config中——no_local为 true 且协议版本非 V5 时直接拒绝确保配置层与协议层一致。订阅配置中的noLocal会随 SUBACK 成功后持久化到saved_topic_configs并在恢复订阅时重新应用restore_desired_subscriptions读取no_local_topics集合client.rs。展示层消息列表按方向左右分流。MqttAdminConsole.vue对每条消息根据msg.direction sent应用不同的样式与徽标MqttAdminConsole.vue发出的消息靠右、绿色边框、标注mqttSent接收的消息靠左、蓝色边框、标注mqttReceived。计划进一步要求提供全部/接收/发送方向过滤。由于 Rust 端在 mqtt.rs 将MqttMessageDirection序列化为sent/received前端可以直接按该值做三态过滤计算。验收标准解读修复计划的四条验收标准与四个实施模块一一对应发布面板选择 JSON 后发布面板不消失合法 JSON 可发布非法 JSON 有错误提示——由参数化 placeholder encodePayload的JSON.parse校验共同保证订阅持久化断线重连、关闭并重新打开 DBX 后已保存 Topic、QoS 和选项自动恢复——由saved_topics落盘 restore_desired_subscriptions双路径恢复保证注意断线重连依赖原有内存态恢复逻辑重启应用依赖新增的持久化逻辑二者必须同时工作TLSTLS、CA、自签 CA、客户端证书认证均可连接错误证书给出明确错误——对应certificate_tls_configuration中自定义 CA / WebPKI 根 / 跳过验证三条路径与证书解析错误信息No Local 与方向区分MQTT 5 开启 No Local 后不再出现 broker 回送副本关闭后发送和接收消息仍能按方向区分——对应filter.nolocal与direction左右分流。验证命令与工程实践文档给出的三条验证命令覆盖前端类型检查、前端单元测试与 Rust 核心测试pnpm typecheck pnpm test cargo test -p dbx-core --features mq-admin mqtt其中第三条值得说明MQTT 管理模块在 admin/mod.rs 中由#[cfg(feature mq-admin)]条件编译控制因此测试必须显式携带--features mq-adminmqtt是该 feature 下的模块名。仓库中 client.rs 的测试覆盖了 topic 树构建、通配符过滤校验、tlsSkipVerify传输构建等关键行为可作为回归参考。Rust 测试还包含一个值得注意的子进程用例verified_tls_does_not_depend_on_platform_certificate_store它验证了系统根证书不可用时使用内置 WebPKI 根的 TLS 配置依然有效这一跨平台约束。小结这份修复计划清晰地展示了 dbx 处理 MQTT 功能缺陷的完整方法论先通过 issue 分级确认影响面再逐条定位根因I18n 插值、内存态丢失、声明与实现脱节、协议能力缺失随后按 P0/P1 分四步实施每一步都配套验收标准与自动化验证。从当前仓库源码看saved_topics持久化结构、save_topic_config/delete_topic_config接口、No Local 的 V5 校验与Filter.nolocal实现、以及证书 TLS 的三条构建路径均已落地验证命令也已在 修复计划 中固化——读者可以直接对照 mqtt.rs 与 client.rs 追踪每条修复的实现细节也可以参考前端 MqttAdminConsole.vue 与 MqttPublishDialog.vue 理解交互侧行为。【免费下载链接】dbx25 MB lightweight cross-platform database client for 90 databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90 数据库提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。项目地址: https://gitcode.com/gh_mirrors/dbx7/dbx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 dbx MQTT 客户端问题修复实战：JSON 发布面板、Topic 持久化、TLS 证书登录与 No Local 消息分流
dbx MQTT 客户端问题修复实战JSON 发布面板、Topic 持久化、TLS 证书登录与 No Local 消息分流【免费下载链接】dbx25 MB lightweight cross-platform database client for 90 databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90 数据库提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。项目地址: https://gitcode.com/gh_mirrors/dbx7/dbx本文是 dbx 开源仓库中 MQTT Issues 修复计划 的展开解读与源码级分析。dbx 内置的 MQTT 管理控制台承担着 broker 连接、Topic 订阅/发布、消息查看等职责而这份修复计划针对社区反馈的 5 个真实问题发布面板崩溃、Topic 丢失、缺少 TLS 证书登录、订阅回送副本、消息方向无法区分给出了从根因定位到验收标准的完整方案。读完本文你将理解每个问题背后的技术根因Vue I18n 插值、进程内存态、Rustls 握手、MQTT 5 订阅选项等并掌握与仓库实现一一对应的修复路径与验证方法。问题清单与优先级划分修复计划围绕 5 个关联 issue 展开按影响程度分为 P0阻断性缺陷与 P1体验性缺陷编号优先级问题描述关联能力#5471P0JSON 发布面板消失重新打开后 Topic 丢失发布面板渲染#5490P0断线后 Topic 丢失缺少 SSL 证书登录订阅持久化 TLS#5450P0Payload 切换为 JSON 后发送框消失发布面板渲染#5448P1禁止 MQTT 本地转发、消息分区展示No Local 消息方向#5456P1保存 Topic 配置订阅持久化其中三个 P0 直接导致核心发布功能不可用或数据丢失因此修复计划将发布面板稳定性与订阅配置持久化放在最优先的位置。现状与根因四条问题链的源码印证根因 1JSON placeholder 中的花括号被 Vue I18n 当作插值表达式发布面板的输入提示是根据编码格式动态切换的。在 MqttPublishDialog.vue 中JSON 编码的占位符通过 i18n 消息渲染case json: return t(connection.mqttPayloadPlaceholderJson, { example: {key: value} });问题在于如果语言包中直接硬编码了原始 JSON 示例文本包含未转义的{...}花括号Vue I18n 会把这些花括号当作插值表达式编译导致模板解析异常进而使整个发布组件渲染失败——这就是选择 JSON 后发布面板消失、发送框消失的直接原因。修复方向是改为安全参数插值把示例 JSON 通过 i18n 的命名参数传入如上面代码中{ example: {key: value} }语言包里只保留{example}占位符避免未转义花括号进入语言包源码。根因 2Topic 只存在于客户端进程内存MQTT Topic 在修复前只保存在MqttClient的进程内存中。从 client.rs 可以看到客户端内部维护了三套订阅集合subscriptions当前 broker 已通过 ACK 确认的 topic 集合granted_subscriptionsbroker 最近一次实际授予的 QoS用于恢复持久会话显示desired_subscriptions需要在无会话重连后恢复的 topic 集合。这套设计能覆盖同一客户端网络重连的场景——事件循环收到 CONNACK 后若session_present为 false会调用restore_desired_subscriptionsclient.rs重新发起订阅。但一旦重建客户端或重启应用这些内存状态全部丢失因为没有任何持久化载体。修复计划给出的答案是把订阅配置写入连接配置并落盘。根因 3证书认证类型声明与实现脱节在类型层面mqtt.rs 中MqttAuth早已声明了Certificate变体包含caCertPath、clientCertPath、clientKeyPath三个可选字段前端 mqtt.ts 也同步定义了kind: none | password | certificate。但实际存在两处脱节连接 UI 只提供无认证和账号密码两种虽然 ConnectionDialog.vue 已经定义了mqttAuthKind与证书路径字段但证书认证的完整交互选择与校验 CA、客户端证书、客户端私钥需要补齐Rust TLS 构建只应用账号密码在 client.rs 中apply_credentials_v4/v5只处理MqttAuth::Password分支Certificate分支不会进入 TLS 配置。根因 4消息有方向字段但订阅缺 No Local 选项消息结构体MqttMessage已经携带direction字段sent/received见 mqtt.rs。发布路径中客户端在 client.rs 构造消息时显式标记direction: MqttMessageDirection::Sent收到的消息则标记为Received。问题在于订阅请求没有 MQTT 5 的 No Local 选项。MQTT 5.0 规范规定如果订阅设置了 No Localbroker 不会把客户端自己发布的消息回送给该客户端。缺少这个选项时客户端发布到自己订阅的 Topic会看到 broker 回送的自己发出去的副本消息列表里出现重复且难以区分的内容。实施顺序与源码级修复方案1. P0JSON 发布面板稳定性三个动作缺一不可JSON 示例改为安全参数插值即根因 1 中的方案语言包只保留{example}命名参数保持 Payload textarea 和发布按钮在编码切换后继续挂载MqttPublishDialog.vue中 textarea 与按钮是平级静态节点模板结构编码切换只更新encodingref 与占位符不应触发组件重建增加切换所有 Payload 编码的组件回归测试并覆盖非法 JSON。关于非法 JSON 的兜底前端编解码工具 mqttPayloadCodec.ts 的encodePayload是天然校验点JSON 分支先执行JSON.parse(input)再重新序列化任何语法错误都会抛出编码失败 (JSON): ...异常发布流程捕获后写入error状态并展示MqttPublishDialog.vue。该模块共支持六种编码plaintext、json、base64、hex、cbor、msgpack其中 CBOR/MsgPack 同样以 JSON 文本作为输入再序列化为二进制。2. P0/P1Topic 持久化这是修复计划中设计最完整的一块仓库源码已经落地了对应结构配置层MqttConnectionConfig新增saved_topics: VecMqttSavedTopic字段mqtt.rs序列化名savedTopics并通过#[serde(default, skip_serializing_if Vec::is_empty)]保证旧连接配置没有该字段也能正常解析实现向后兼容。单个订阅条目MqttSavedTopicmqtt.rs包含字段类型说明topicstring订阅过滤器qosMqttQoS默认atmostoncenoLocalbool是否启用 MQTT 5 No Localenabledbool是否在连接时自动恢复订阅旧配置缺失时按true处理状态层客户端新增saved_topic_configs含禁用条目与no_local_topics两个集合client.rs。客户端创建时new_with_backendclient.rs直接从config.saved_topics初始化desired_subscriptions与no_local_topics只取enabled的条目。订阅/取消订阅联动订阅成功收到 SUBACK后complete_subscribe_ackclient.rs会把 topic 的 qos、noLocal、enabled 更新或追加进saved_topic_configs取消订阅成功收到 UNSUBACK后complete_unsubscribe_ackclient.rs不会物理删除条目而是把enabled置为false保留配置便于用户重新启用同时提供了两个直接操作配置的接口save_topic_configclient.rs与delete_topic_configclient.rs前者按 topic 合并更新后者在用户显式删除时移除条目。前端 api.ts 已暴露mqttSaveTopicConfig、mqttDeleteTopicConfig、mqttListSavedTopicConfigs三个命令。恢复流程保留原有网络重连恢复逻辑restore_desired_subscriptions同时在客户端创建与首次 CONNACK 后恢复保存的订阅。handle_connackclient.rs判断session_present如果 broker 保留了持久会话直接恢复granted_subscriptions否则清空当前订阅并异步执行restore_desired_subscriptions。合并更新计划要求使用按连接 ID 的合并更新避免覆盖用户同时修改的其他连接字段。这意味着前端在保存连接配置时只把savedTopics数组合并回原external_config而不是整体替换 MQTT 配置对象从而保护用户在同一会话中修改的其他字段。3. P0TLS 与证书登录UI 层增加 CA 证书、客户端证书、客户端私钥的选择与校验。前端连接表单的mqttAuthKind已支持certificate分支ConnectionDialog.vue回填caCertPath、clientCertPath、clientKeyPath提交时构造{ kind: certificate, caCertPath, clientCertPath, clientKeyPath }第 1477-1479 行。校验规则与后端一致证书认证必须启用 TLS且三个路径的完整性需要校验。Rust 层build_transportclient.rs根据tls_verification_modeVerifyServerCert/SkipServerCertVerification源自tls与tlsSkipVerify的组合和认证方式选择传输certificate_tls_configurationclient.rs负责构建 mTLS 配置其内部逻辑值得细读CA 处理若配置了caCertPath用rustls_pemfile::certs解析并加入RootCertStore未配置则回退到webpki_roots::TLS_SERVER_ROOTS系统根证书之外的内置 WebPKI 根校验模式VerifyServerCert使用标准with_root_certificatesSkipServerCertVerification通过自定义的NoCertificateVerification校验器跳过服务端证书验证client.rs它只校验 TLS 1.2/1.3 签名算法不对证书链做任何信任判断mTLS 客户端认证客户端证书与私钥必须成对出现缺任一都会报错缺少客户端证书路径/私钥路径两路都提供时调用with_client_auth_cert(certs, key)传输映射TCP 走Transport::tls_with_configWebSocket 走Transport::wss_with_config。另有verified_tls_configuration系统 WebPKI 根 无客户端认证与insecure_tls_configuration跳过验证 无客户端认证供非证书场景复用。安全约束只保存证书路径绝不把私钥内容写入连接配置——MqttAuth::Certificate的三个字段都是OptionString路径而非内容这一点在 mqtt.rs 的类型定义层面就保证了。配置校验from_connectionmqtt.rs还会拒绝证书认证但未启用 TLS的组合。4. P1No Local 与消息分流协议层MqttBackendClient::subscribeclient.rs按协议版本分流MQTT 5构造MqttV5Filter后显式设置filter.nolocal no_local再通过subscribe_many发送MQTT 3.x直接返回错误MQTT 3.x 不支持 No Local 订阅选项。同样的约束也出现在MqttClient::subscribeclient.rs与save_topic_config中——no_local为 true 且协议版本非 V5 时直接拒绝确保配置层与协议层一致。订阅配置中的noLocal会随 SUBACK 成功后持久化到saved_topic_configs并在恢复订阅时重新应用restore_desired_subscriptions读取no_local_topics集合client.rs。展示层消息列表按方向左右分流。MqttAdminConsole.vue对每条消息根据msg.direction sent应用不同的样式与徽标MqttAdminConsole.vue发出的消息靠右、绿色边框、标注mqttSent接收的消息靠左、蓝色边框、标注mqttReceived。计划进一步要求提供全部/接收/发送方向过滤。由于 Rust 端在 mqtt.rs 将MqttMessageDirection序列化为sent/received前端可以直接按该值做三态过滤计算。验收标准解读修复计划的四条验收标准与四个实施模块一一对应发布面板选择 JSON 后发布面板不消失合法 JSON 可发布非法 JSON 有错误提示——由参数化 placeholder encodePayload的JSON.parse校验共同保证订阅持久化断线重连、关闭并重新打开 DBX 后已保存 Topic、QoS 和选项自动恢复——由saved_topics落盘 restore_desired_subscriptions双路径恢复保证注意断线重连依赖原有内存态恢复逻辑重启应用依赖新增的持久化逻辑二者必须同时工作TLSTLS、CA、自签 CA、客户端证书认证均可连接错误证书给出明确错误——对应certificate_tls_configuration中自定义 CA / WebPKI 根 / 跳过验证三条路径与证书解析错误信息No Local 与方向区分MQTT 5 开启 No Local 后不再出现 broker 回送副本关闭后发送和接收消息仍能按方向区分——对应filter.nolocal与direction左右分流。验证命令与工程实践文档给出的三条验证命令覆盖前端类型检查、前端单元测试与 Rust 核心测试pnpm typecheck pnpm test cargo test -p dbx-core --features mq-admin mqtt其中第三条值得说明MQTT 管理模块在 admin/mod.rs 中由#[cfg(feature mq-admin)]条件编译控制因此测试必须显式携带--features mq-adminmqtt是该 feature 下的模块名。仓库中 client.rs 的测试覆盖了 topic 树构建、通配符过滤校验、tlsSkipVerify传输构建等关键行为可作为回归参考。Rust 测试还包含一个值得注意的子进程用例verified_tls_does_not_depend_on_platform_certificate_store它验证了系统根证书不可用时使用内置 WebPKI 根的 TLS 配置依然有效这一跨平台约束。小结这份修复计划清晰地展示了 dbx 处理 MQTT 功能缺陷的完整方法论先通过 issue 分级确认影响面再逐条定位根因I18n 插值、内存态丢失、声明与实现脱节、协议能力缺失随后按 P0/P1 分四步实施每一步都配套验收标准与自动化验证。从当前仓库源码看saved_topics持久化结构、save_topic_config/delete_topic_config接口、No Local 的 V5 校验与Filter.nolocal实现、以及证书 TLS 的三条构建路径均已落地验证命令也已在 修复计划 中固化——读者可以直接对照 mqtt.rs 与 client.rs 追踪每条修复的实现细节也可以参考前端 MqttAdminConsole.vue 与 MqttPublishDialog.vue 理解交互侧行为。【免费下载链接】dbx25 MB lightweight cross-platform database client for 90 databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90 数据库提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。项目地址: https://gitcode.com/gh_mirrors/dbx7/dbx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考