单片机与物联网 / 系统课时
订阅成功却没消息怎么查
订阅成功却没消息怎么查
客户端已经收到 SUBACK,却一直收不到业务数据,通常是发布端未成功发送、Topic 不匹配、ACL 拦截,或消息虽转发却被会话与应用处理逻辑影响。本课用一次可复现的发布订阅实验,逐段确认消息实际停在哪个环节。
学习目标
- 解释 SUBACK 成功与“已有消息到达”之间的区别。
- 用两端命令验证发布、Topic 匹配和订阅接收。
- 通过 Broker 记录检查 ACL、QoS、会话和离线行为。
先建立一条可以复现的消息链路
在允许本机测试账号读写该 Topic 的 Mosquitto Broker 上打开两个终端。先启动订阅端,防止一条非保留消息在订阅建立前已经发出。这里使用独立 Client ID 和 QoS 1,避免测试客户端互相接管会话。
订阅端执行:
mosquitto_sub -h 127.0.0.1 -p 1883 -V mqttv5 -i diag-sub-09 -t 'factory/line1/sensor01/temperature' -q 1 -v -d -C 1 -W 30预期输出(先确认订阅成功,随后等待发布;以下为关键行):
Client diag-sub-09 received CONNACK (0)
Client diag-sub-09 received SUBACK
Subscribed (mid: 1): 1保持订阅端运行,再在另一个终端执行:
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv5 -i diag-pub-09 -t 'factory/line1/sensor01/temperature' -m '27.4' -q 1预期结果:发布端成功后通常没有标准输出;订阅端打印下面一行后退出。
factory/line1/sensor01/temperature 27.4若在三十秒内没有收到该行,先检查这两个命令是否连接同一个 Broker 实例、测试账号是否有相应权限,以及发布是否发生在 SUBACK 之后。不要直接把超时当成 QoS 故障。
按消息经过的节点逐段定位
SUBACK 的成功码 0x00、0x01、0x02 表示 Broker 接受了对应订阅过滤器及其授予的 QoS,不保证已经存在匹配的发布消息。追踪时先确认发布端 PUBLISH 被 Broker 接收,再看是否有匹配的订阅与可授权的接收方,最后才检查订阅端网络和业务回调。

实际项目可在 Broker 临时提高日志详细度,对齐同一条测试消息的 Topic、发布客户端和订阅客户端。若日志有“收到 PUBLISH”却没有向订阅端转发的迹象,优先检查过滤器与授权;若已有转发记录,则转查订阅客户端是否保持连接及是否处理了回调。
重点核对 Topic 与双向 ACL
Topic 匹配区分大小写和首部斜杠,factory/a 与 /factory/a 是两个不同名称。订阅过滤器 factory/+/temperature 只匹配中间恰好一级,factory/# 可匹配该前缀下的多级;# 不会自动匹配以 $ 开头的系统主题。
| 发布的 Topic | 订阅过滤器 | 结果 |
|---|---|---|
factory/line1/temperature |
factory/+/temperature |
匹配 |
factory/line1/sensor01/temperature |
factory/+/temperature |
不匹配 |
factory/line1/sensor01/temperature |
factory/# |
匹配 |
同时分别核查发布身份对该 Topic 的写权限,以及订阅身份对相关消息的读权限。有些 Broker 可以接受 SUBSCRIBE,却在转发时按具体 Topic 再次授权,因此“订阅成功”不能作为 ACL 已全部放行的证据。MQTT 5 的 SUBACK 若返回 0x87,则表示该订阅未获授权,不能视为成功。
排除会话、时机和 QoS 的误会
如果相同测试 Topic 可以收到消息,而原业务客户端仍失败,继续检查下面几种条件:
- 先发布、后订阅:普通非保留消息不会因新订阅而补发;需要最新状态快照时才考虑 retained。
- 离线或过期:QoS 0 不保证离线补发;QoS 1/2 离线队列依赖会话保留、有效订阅及 Broker 策略,消息也可能因过期被删除。
- Client ID 重复:后连接的客户端可能接管相同 ID 的旧连接,导致看似在线的原消费者停止收包。
- 共享订阅:
$share/group/factory/#在同一共享组内将每条匹配消息分配给一个成员,并非广播给全部成员。 - 应用侧过滤:Broker 已向客户端转发,但 SDK 回调、业务条件或消费队列丢弃消息,应加接收计数并对照原始负载。
MQTT 5 下,QoS 1 的 PUBACK 成功只说明发布端到接收它的 Broker 这一跳已被接受,不代表指定订阅者完成业务处理;PUBACK 的 0x10 可表示没有匹配订阅者,但不是所有故障都能靠它单独判断。
用证据确认真正的断点
最终保存一份最小排障记录:Broker 地址与监听器、发布和订阅两个 Client ID、完整 Topic、过滤器、双方 QoS、发布时间、SUBACK/PUBACK 结果,以及 Broker 是否向订阅端发送 PUBLISH。修复后在原账号与原过滤器下重做相同测试,再让实际应用验证收到 27.4 并执行一次业务回调。
如果命令行工具能收到而业务程序不能收到,重点落在应用连接参数、会话与回调代码;如果工具也收不到,就继续沿 Broker 的路由与授权证据排查。