单片机与物联网 / 系统课时
用客户端完成第一次消息收发
用客户端完成第一次消息收发
不写应用代码,也能验证 MQTT 消息能否穿过 Broker。你将在本机启动服务,用两个命令行客户端分别订阅和发布温度消息,最后从订阅端看到主题及内容,并能定位常见的收发失败。
学习目标
- 区分 Broker、发布客户端和订阅客户端在链路中的职责。
- 使用 Mosquitto 命令行完成一次订阅和发布。
- 根据客户端输出排查连接失败、主题不一致和收发顺序错误。
看清消息经过的路径
MQTT 发布端不会向订阅端直接发送数据。订阅端先向 Broker 声明感兴趣的 Topic;发布端随后将消息交给 Broker,Broker 再按 Topic 匹配结果分发。发布者只需知道 Broker 地址,不必知道监控程序部署在哪里。

本次统一使用 lab/device01/telemetry/temperature 作为主题、26.5 作为载荷。主题决定谁会收到消息;载荷是传输的实际业务数据,两者不要混为一谈。
启动一个只供本机测试的 Broker
先安装 Eclipse Mosquitto,确认终端能找到 mosquitto、mosquitto_sub 和 mosquitto_pub。打开终端 A,启动 Broker:
mosquitto -p 1883 -v预期结果:进程持续运行,显示 Broker 启动与监听日志;日志时间等动态信息可能不同。本例明确使用本机端口 1883,实际环境的端口可能不同,后续客户端的 -p 必须与它一致。
未单独配置监听器的 Mosquitto 2.x 默认只接受本机回环连接,适合这一练习,不代表已具备远程设备接入能力。若端口被已有 Broker 占用,可复用已运行且允许本机连接的服务,避免启动第二个同端口进程。
先订阅,再发布
打开终端 B,执行订阅。-h 指定 Broker 主机,-t 指定主题,-v 让收到的消息同时显示 Topic 与载荷:
mosquitto_sub -h 127.0.0.1 -p 1883 -t 'lab/device01/telemetry/temperature' -v预期结果:命令保持运行并等待消息,暂时没有业务数据输出。不要关闭这个终端,否则后续发布时没有在线订阅者可接收。
另开终端 C,发送一条温度值。-m 后是消息载荷;本例不使用保留消息,也不配置离线消息恢复:
mosquitto_pub -h 127.0.0.1 -p 1883 -t 'lab/device01/telemetry/temperature' -m '26.5'预期结果:发布命令正常退出,终端 C 通常不打印业务消息;终端 B 则出现:
lab/device01/telemetry/temperature 26.5这里看到的不是 Broker 自动生成的温度,而是发布端送出的原始载荷。若把订阅端的 -v 去掉,通常只会显示 26.5。
根据现象排查收发问题
若客户端提示连接被拒绝,先检查终端 A 是否还在运行,再核对主机 127.0.0.1 与端口 1883。若连接成功但收不到数据,确认订阅命令已先启动,并逐字比较两端的主题;MQTT 的主题区分大小写。
如果仅发布端退出而订阅端没有输出,不能据此证明消息已送达。先让订阅端保持在线,再重新发布同一条消息;这一练习默认采用 QoS 0,且没有设置 retained 标志,不会自动向后来订阅的客户端补发历史数据。
验证完成后可在终端 B 按 Ctrl+C 停止订阅,终端 A 也可按 Ctrl+C 停止临时 Broker。能稳定重现订阅端输出后,才算验证了连接、订阅、发布和路由这条完整链路。