ESP32使用painlessMesh组网时添加BLE扫描导致节点无法连接

核心原因 #

ESP32的WiFi（painlessMesh依赖）与BLE共享同一射频前端，同时运行会抢占资源；若BLE扫描采用阻塞式调用，会导致mesh.update()无法定期执行，Mesh的连接维护、心跳机制中断，最终引发组网失败或断连。

具体修复步骤 #

1. 改用异步BLE扫描，避免阻塞Mesh任务 #

不要使用阻塞式的pBLEScan->start(scanTime, true)，改用异步扫描+回调的方式，确保主循环能持续执行mesh.update()：

// 全局变量
BLEScan* pBLEScan;

// 扫描完成回调函数
void scanCompleteCB(BLEScanResults results) {
    // 转换扫描结果为字符串
    String scanStr = "";
    for (int i = 0; i < results.getCount(); i++) {
        BLEDevice dev = results.getDevice(i);
        scanStr += dev.getAddress().toString() + "|" + String(dev.getRSSI()) + ";";
    }
    // 广播扫描结果到Mesh
    mesh.sendBroadcast(scanStr);
    
    // 延迟1-3秒后启动下一次扫描（给Mesh留足通信时间）
    pBLEScan->start(2, false);
}

void setup() {
    // 初始化Mesh
    mesh.init(MESH_PREFIX, MESH_PASSWORD, MESH_PORT, STA_AP, 6, 1);
    
    // 初始化BLE
    BLEDevice::init("Mesh-BLE-Scanner");
    pBLEScan = BLEDevice::getScan();
    pBLEScan->setActiveScan(false); // 改用被动扫描，降低射频占用
    pBLEScan->setScanCompleteCB(scanCompleteCB); // 设置扫描完成回调
    
    // 启动第一次异步扫描
    pBLEScan->start(2, false);
}

void loop() {
    // 必须持续调用，维护Mesh连接
    mesh.update();
}

2. 启用WiFi-BLE共存模式 #

让系统自动调度射频资源，减少冲突：

• 若使用PlatformIO，在platformio.ini中添加：

  build_flags = 
      -DCONFIG_BT_WIFI_COEXIST_ENABLED=1
  

• 若使用Arduino IDE，在代码开头添加：

  #define CONFIG_BT_WIFI_COEXIST_ENABLED 1
  

3. 优化Mesh参数，降低射频冲突概率 #

调整Mesh的心跳、连接参数，减少高频通信对射频的占用：

// 延长心跳间隔（默认2000ms，改为5000ms）
mesh.setHeartbeatInterval(5000);
// 延长连接超时时间（默认5000ms，改为10000ms）
mesh.setConnectionTimeout(10000);

4. 调整BLE扫描参数，减少资源消耗 #

• 保持被动扫描：pBLEScan->setActiveScan(false)，被动扫描仅监听广播包，不主动发送扫描请求，射频占用远低于主动扫描。
• 若必须用主动扫描，降低扫描占空比：

  pBLEScan->setInterval(100); // 扫描间隔100ms
  pBLEScan->setWindow(50);    // 扫描窗口50ms（占空比50%）
  

验证要点 #

• 确保所有节点的Mesh参数（前缀、密码、端口）完全一致。
• 测试时先启动根节点，再依次启动其他节点，避免同时启动引发射频拥堵。

内容的提问来源于stack exchange，提问作者Simone Colombo