MQTT 实时数据接入:连接、主题、字段与消息预览
MQTT 适合接收设备持续上报的消息,例如温度、湿度或设备状态。先准备可用的 Broker 连接,再建立具体主题的数据源。
新建连接与订阅
先按连接配置建立 MQTT 连接。进入「数据管理」点击「新增MQTT」,填写名称,选择 MQTT 数据连接,再设置订阅消息主题。
主题示例:
factory/line-a/sensor-01
主题应与实际发布方约定一致,包括大小写与层级。不要把设备名称直接当作主题,也不要把 Broker URL 填入主题栏。
约定消息结构
本教程使用的消息示例:
{"device":"sensor-01","temperature":26.4,"humidity":58,"status":"online"}
填写 device、temperature、humidity、status 等实际字段。在数字组件中绑定 temperature,可以用于观察当前温度。
建议让设备方保持字段名称和数值类型稳定。平台使用 JSON 消息更新数据,不能假定任意二进制报文都会自动被解码。
预览需要新消息
打开消息预览后,让设备或发布工具发送一条已知内容的消息。没有新消息时,预览可能暂时为空,不能仅凭空白就判断配置错误。
确认主题收到正确数据,再进入图表或数字组件完成绑定。大屏刷新是否正常,最后要用真实设备消息或受控测试消息验证。
排查顺序
Broker 地址和协议 → 账号及客户端 ID → 订阅主题 → 是否产生新消息 → JSON 结构 → 字段映射。
多个连接使用相同客户端 ID 可能相互影响。消息收到但组件不变时,先核对字段名与数据格式,而不是反复重建整个项目。
界面参考
