ESP32 BLE设备首次连接后广播停止问题排查求助

问题概述 #

• 开发环境：基于Arduino IDE开展ESP32 BLE功能开发
• 预期需求：BLE设备保持持续广播模式
• 异常表现：设备与移动端BLE App建立一次连接后广播自动终止，后续无法在nRF Connect、BLE Scanner等工具中搜索到设备广播，也无法再次建立连接，仅对ESP32开发板执行硬复位后才会重新开始广播
• 复现规律：在3台以上设备编译测试，仅1台设备编译的内置BLE_server示例运行正常，其余3台设备编译出的固件均存在上述广播停止问题；已尝试升级Arduino IDE版本、ESP32板级支持包版本，问题未解决
• 当前环境版本：Arduino IDE 1.8.13，Java(TM) SE Development Kit 18.0.1.1（64位），Python 2.7.15，Arduino IDE配置参考截图：

故障根因 #

1. 核心逻辑缺失（占同类故障90%以上）：该问题大概率不是编译环境导致。ESP32 Arduino BLE库默认行为为：BLE连接建立后自动暂停广播，连接断开后不会自动恢复广播，必须由开发者在连接断开回调函数中手动调用广播启动接口。1台设备编译的示例运行正常，基本可判定为该设备上的BLE库被打过第三方补丁、或本地存储的示例代码被人为添加过广播重启逻辑，其余设备使用官方原生库时就会触发该默认行为。
2. 编译环境兼容性问题：当前环境配置存在已知兼容缺陷，会提升故障出现概率：Arduino IDE 1.8.x系列内置适配的JDK 8运行环境，手动安装的JDK 18会被IDE优先调用，和旧版IDE存在API兼容问题，可能导致BLE库的弱函数绑定、宏定义解析异常；Python 2.7已停止维护，2.0.0以上版本的ESP32板级支持包完全依赖Python 3，旧版Python会导致编译阶段预编译脚本执行异常，生成的固件存在逻辑缺陷。
3. BSP版本碎片化问题：不同设备上安装的ESP32板级支持包小版本不一致，部分早期2.x版本的ESP32 BLE库存在连接断开后广播状态位未复位的已知bug，即使手动调用广播启动接口也无法正常拉起广播。

修复步骤 #

按优先级依次操作：

1. 补全BLE生命周期逻辑
   在BLE业务代码中添加连接状态回调，在断开连接事件中主动重启广播，可直接参考如下代码片段：

   // 定义全局广播对象指针
   BLEAdvertising *pAdvertising;
   
   // 实现BLE服务回调
   class MyServerCallbacks: public BLEServerCallbacks {
       void onConnect(BLEServer* pServer) {
         // 连接建立后的业务逻辑可在此添加，无需操作广播
       };
       void onDisconnect(BLEServer* pServer) {
         // 延迟500ms重启广播，规避BLE协议栈忙状态
         delay(500);
         pAdvertising->start();
       }
   };
   
   void setup() {
     BLEDevice::init("ESP32_BLE_Device");
     BLEServer *pServer = BLEDevice::createServer();
     // 绑定连接状态回调
     pServer->setCallbacks(new MyServerCallbacks());
     pAdvertising = BLEDevice::getAdvertising();
     // 此处添加自定义广播参数配置，如服务UUID、设备名称等
     pAdvertising->start();
   }
   
   void loop() {
     // 业务循环逻辑
   }
   

2. 统一修正编译环境
   • 删除系统环境变量中配置的外部JDK路径，Arduino IDE 1.8.x无需单独安装外部JDK，使用内置JRE即可避免版本冲突
   • 将系统默认Python版本替换为3.8及以上的3.x版本，适配新版ESP32板级支持包的编译依赖
   • 所有编译设备统一安装2.0.17稳定版ESP32板级支持包，安装前彻底删除旧版BSP缓存（路径通常为C:\Users\<用户名>\AppData\Local\Arduino15\packages\esp32），避免旧文件残留
3. 一致性校验
   开启Arduino IDE编译详细输出，确认所有设备编译时调用的BSP版本、依赖库路径完全一致，避免某台设备误用手动安装的第三方修改版BLE库。

内容的提问来源于stack exchange，提问作者Annakkili Arumugam