OpenMQTTGateway项目中BLE读取电池服务时的MQTT消息损坏问题分析

在OpenMQTTGateway项目的ESP32-WROOM-32D开发板上运行esp32dev-ble二进制文件时，发现了一个关于BLE电池服务读取的MQTT消息损坏问题。本文将详细分析该问题的表现、原因及解决方案。

问题现象

当尝试通过MQTT命令读取蓝牙设备的电池电量时（标准蓝牙SIG电池服务180f/2a19），系统返回的MQTT消息出现严重损坏。具体表现为：

1. 响应消息被发布到错误的主题（如"d"主题）
2. 消息内容中的ID字段异常（如"id":"d"）
3. 主题路径有时会被错误地拼接（如home/internal被错误地合并到home/OMG_ESP32_BLE/BTtoMQTT列表中）

值得注意的是，这种损坏主要发生在成功响应的情况下，而由网关自身产生的失败响应（当设备无响应时）通常表现正常。

问题重现

该问题可以通过以下MQTT命令重现：

• 命令主题：home/OMG_ESP32_BLE/commands/MQTTtoBT
• JSON负载：

{
	"ble_read_address": "AA:BB:CC:DD:EE:FF",
	"ble_read_service": "180f",
	"ble_read_char": "2a19",
	"value_type": "INT",
	"ttl": 4,
	"immediate": true
}

问题排查

经过深入排查，发现问题与以下因素相关：

1. 当使用手动WiFi、MQTT和网络定义的环境时，问题更容易出现
2. 问题与特定的编译标志配置有关，特别是当启用NetworkAdvancedSetup和手动网络配置时
3. 问题在标准预构建二进制文件和自定义编译环境中表现不同

根本原因

问题的根本原因在于BLE数据处理过程中ID字段的处理方式。原始代码中使用了指向临时字符串的指针来设置BLEdata["id"]，这会导致：

1. 当临时字符串超出作用域后被释放
2. 指针指向的内存区域被重用
3. 最终导致MQTT消息中的ID字段损坏

解决方案

修复方案是将BLEdata["id"]的赋值从使用临时字符串指针改为使用持久本地变量。具体修改包括：

1. 在BLE数据处理函数中声明局部字符串变量存储ID
2. 使用该变量的副本而非指针来设置JSON对象中的ID字段
3. 确保ID数据在整个消息处理周期内保持有效

这种修改确保了ID数据在MQTT消息发布前不会被意外修改或释放，从而解决了消息损坏问题。

验证结果

经过修复后，系统表现如下：

1. 所有BLE读取和写入操作的响应消息都能正确发布到指定主题
2. 消息内容中的ID字段保持正确
3. 主题路径拼接不再出现错误
4. 系统在各种操作条件下（成功/失败响应）表现一致稳定

该修复已通过持续半小时的电池电量读取测试验证，未再出现消息损坏情况。

技术启示

这个案例提醒我们：

1. 在处理JSON数据时，必须注意数据生命周期的管理
2. 指针使用需要谨慎，特别是在涉及跨作用域数据传输时
3. 对于MQTT这类异步通信系统，确保数据在整个发布周期内有效至关重要
4. 即使是长期稳定的代码，在特定配置或环境变化下也可能暴露出隐藏的问题

这个问题虽然表现特殊，但其根本原因具有普遍意义，值得嵌入式系统和物联网开发者借鉴。