MQTT 通配符漏收消息，怎样验证空层级与系统主题

2026-10-24

MQTT 通配符按主题层级匹配，空层级也算一层。“a/+/c”可以匹配“a//c”；“a/#”既可以匹配子层级，也可以匹配父主题“a”。以$开头的系统主题还有额外边界：以#或+开头的普通过滤器不会直接匹配它们，需要明确订阅相应前缀。

环境和证据范围

只讨论MQTT5普通非共享订阅的合法过滤器。附件是小型匹配向量，不实现共享订阅、ACL或所有非法语法检查；服务器还可以有自己的可用功能限制。发布主题不能包含订阅通配符，测试时不要把两者写反。

把Topic Filter按/拆层，保留空字符串，不能用忽略空项的split配置。逐层比较时，+消耗恰好一层，#只能在完整末层，允许匹配零个或更多层。
先验正常层级，再加入“a”“a/”“a//c”这些边界输入。对系统主题单列“#”“$SYS/#”两条过滤器，避免拿普通传感点测试通过就推断运维系统主题也能收到。
把每个命中结果与现场SUBACK结果分开记录。过滤器理论匹配并不代表权限允许；同一主题被多条订阅覆盖时还可能影响分发观察，排查时优先使用单一过滤器。

附件预期：a/+/c对a//c为真，对a/c为假；a/#对a为真，对a/b/c为真；#对$SYS/broker为假，而$SYS/#对它为真。脚本按照这些输入生成布尔矩阵，并对非法“a/#/b”显式报为过滤器无效。

过滤器匹配测试和发布合法性测试也应分开。+和#只能作为完整层级的订阅通配符，发布者不能把它们当普通主题字符发出去。空层级与空主题不同：连续斜杠可以产生空层，而Topic Name整体仍须满足规范的非空要求。

下载本题合成输入与预期JSON、离线只读核验脚本和现场空白记录CSV。放在同一目录，用 Python 3 运行 python verify.py，逐项计算或解析后与预期比较，失败会显示差异。

现场字段包括 filter、topic、expected_match、suback_code、observed_delivery。合成样例保持原样，实测另存并填写型号、版本、证据路径，未采集处留空。本地核验不代表真实设备、代理、浏览器或长期稳定性已测。

最常见的自制匹配器错误是把空层删掉，或把#实现成至少一个子层。另一种误判是把“$”当普通前缀只测一半规则。若独立脚本通过而代理结果不符，应核对过滤器原始字节、协议版本和代理公开限制，不直接把脚本结论当现场事实。

移交时给每个订阅附上预期命中与禁止命中的测试向量，把系统状态和业务状态主题分开管理。新增主题层级前应先跑这张矩阵，防止一个层级改动让整个展区的数据无声漏收。

需要接入中控时，可对照SoftControl设备联动需求核实适配范围；独立校验方法是否纳入交付需逐项约定。

核对日期：2026-10-24。规范定义与本文应用约定分开，示例门限及脚本不自动代表产品原生能力。

评论发布后会被人工复核，违规内容将被删除。

如果发表没有反应，可以前往联系我们告诉我们。