Payload 格式化
消息检查
MQTT Payload 格式化工具
格式化、压缩并转换 MQTT Payload,便于检查设备遥测、命令和事件消息。
用 Payload Formatter 检查 MQTT 遥测、命令、Retained State 与设备事件,避免在编码问题上浪费排障时间。
Payload 工作流
先让消息体可读,再排查路由。
很多 MQTT 问题看似来自 Broker,实际是 Payload 无效、编码不一致或消费者解析失败。
- 格式化遥测 JSON
- 压缩受限设备测试 Payload
- 用 Base64 传输不透明内容
- 用 Hex 检查二进制边界
遥测设计
Payload 是你的 API 契约。
稳定的设备 Payload 应清晰表达单位、时间戳、设备标识和 Schema 版本。MQTT 负责传递消息,Payload 仍需要可演进结构。
- 演进时包含 schema 或 version
- 明确时间戳单位
- 命令与遥测 Payload 分离
- 避免在 Retained Message 中放秘密
排障
消费者不一致时对比原始与格式化输出。
当规则引擎、Dashboard 或数据库拒绝消息时,先检查 JSON、编码、空白字符和二进制数据。
- 先校验 JSON
- 检查 Unicode 与二进制边界
- 报告问题时保留原始 Payload
- 在 Topic 示例旁保留 Payload 示例