MQTT 基础

MQTT 是轻量级发布订阅协议，常用于物联网、设备状态上报、消息推送和低带宽网络通信。它的核心不是“客户端直接互发”，而是客户端通过 Broker 发布和订阅消息。

核心角色

Topic 设计

示例：

1
2
3
4

device/{deviceId}/telemetry
device/{deviceId}/status
device/{deviceId}/command
device/{deviceId}/event

建议：

• 层级清楚。
• 不要把敏感信息放进 topic。
• 设备 ID 使用稳定唯一标识。
• 上行、下行、事件、状态分开。
• 通配符订阅只给服务端或受控系统使用。

通配符：

QoS

QoS 不是越高越好。多数设备状态上报用 0 或 1 已经足够，业务端要能处理重复消息。

Retained Message

Retain 消息会让 Broker 保留某个 topic 的最后一条消息，新订阅者连接后可以立即收到。

适合：

• 设备最后状态。
• 配置版本。
• 在线状态快照。

不适合：

• 高频遥测数据。
• 一次性控制命令。
• 包含敏感数据的消息。

Last Will

Last Will 用于客户端异常断开时，由 Broker 自动发布遗嘱消息。

常见设计：

1

device/001/status = offline

设备正常上线时发布：

1

device/001/status = online

这样服务端可以更容易判断设备是否异常掉线。

常见端口

具体端口以 Broker 配置为准。

测试命令

安装 Mosquitto 客户端后可以测试。

订阅：

1

mosquitto_sub -h 127.0.0.1 -p 1883 -t 'test/#' -v

发布：

1

mosquitto_pub -h 127.0.0.1 -p 1883 -t 'test/hello' -m 'hello mqtt'

带账号：

1

mosquitto_pub -h 127.0.0.1 -p 1883 -u user -P password -t 'test/hello' -m 'hello'

常见问题

官方入口

• MQTT Version 5.0 OASIS Standard
• MQTT Version 3.1.1 OASIS Standard