Awtrix-Light项目MQTT通知功能中JSON格式问题解析

在物联网设备开发中，MQTT协议因其轻量级和高效性被广泛应用于设备间通信。本文将以Ulanzi Awtrix(TC001)设备为例，分析一个典型的MQTT消息格式问题及其解决方案。

问题现象

用户在使用Awtrix-Light 0.96版本时发现，通过MQTT向设备发送通知消息时出现异常：

• 发送到awtrix_06cf08/notify主题的消息无法正常显示
• 而发送到awtrix_06cf08/custom/test主题的相同内容却能正常显示

根本原因分析

通过深入分析用户提供的MQTT消息内容，发现问题出在JSON格式的构造上。以下是问题消息示例：

{"icon": "23634","text": "80.0 %", "duration": 20 } alias: humidite_terre_ext

这段消息存在两个关键问题：

1. 非法JSON结构：在JSON对象外部附加了alias: humidite_terre_ext文本，这不符合标准JSON格式规范
2. 语法错误：alias字段本应是JSON对象的一部分，但却被放在了对象外部

正确解决方案

正确的JSON消息格式应为：

{
  "icon": "23634",
  "text": "80.0 %",
  "duration": 20
}

如果需要包含alias字段，应该将其作为JSON对象的合法属性：

{
  "icon": "23634",
  "text": "80.0 %",
  "duration": 20,
  "alias": "humidite_terre_ext"
}

技术要点

1. JSON格式严格性：MQTT消息处理器通常对JSON格式有严格要求，任何不符合规范的字符都会导致解析失败
2. 主题差异：不同主题可能对应不同的消息处理器，/notify主题可能使用了更严格的JSON解析器
3. 自动化工具问题：在使用HASS自动化工具生成MQTT消息时，要特别注意模板引擎可能引入的格式问题

最佳实践建议

1. 在构造MQTT消息时，始终使用JSON验证工具检查格式有效性
2. 对于复杂的消息结构，建议先使用静态数据进行测试
3. 在自动化工具中使用模板时，确保最终的输出符合JSON规范
4. 考虑使用MQTT客户端工具(如MQTT Explorer)进行实时消息监控和调试

通过遵循这些实践，可以避免类似的消息格式问题，确保物联网设备间的通信可靠性。