消息检查

MQTT Payload 格式化工具

格式化、压缩并转换 MQTT Payload,便于检查设备遥测、命令和事件消息。

Payload 格式化

快速检查 JSON、Base64 与 Hex 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 示例