MQTT 数据转发

MQTT 转发把新数据发布到指定 Broker 和主题，接收系统通过订阅该主题读取消息。

配置 Broker

管理员或所有者进入组织 → 数据 → 数据分发，新建 MQTT 配置。

字段	填写内容
主机	Broker 主机名或可访问的地址
端口	Broker 实际监听端口
客户端 ID	为该转发连接设置独立 ID，避免与其他客户端冲突
主题	接收系统订阅的主题，例如 site-a/sensor/data
用户名、密码	Broker 要求的连接认证

保存并启用配置。当前表单没有 TLS 证书或加密开关；不能只把端口改为 8883 就认为已启用 TLS。Broker 强制 TLS 时，需先联系平台管理员确认连接方式。

消息格式

消息正文是 JSON 数组，可包含多条点位数据。点位标识、时间和值的示例见 HTTP POST 请求体。订阅端需逐条解析，保留点位标识并统一时间单位。

转发向指定主题发布数据，不会自动建立下行控制主题。通过外部系统控制设备，应使用开放 API。

验证接收

1. 在接收系统使用独立客户端 ID 订阅目标主题。
2. 保持订阅连接，让设备上报新数据。
3. 核对收到消息的点位、时间和值，再检查分发统计。

发布成功与订阅业务处理完成是不同结果。需要留存时，由订阅系统保存消息；不要把 Broker 连接成功视为历史数据备份完成。

订阅不到数据

检查主机、端口、账号权限及发布和订阅主题是否一致。连接反复断开时，检查客户端 ID 冲突。分发统计不增长时，先确认设备确实产生了新上报。