Android 13下多ESP32板BLE配对问题求助

核心原因分析 #

Android 13对BLE配对的权限和流程做了更严格的限制，尤其是当设备使用特定GATT服务/特征或者需要**绑定（Bonding）**时，系统设置路径无法处理自定义配对需求，必须通过应用层触发配对流程。

具体解决步骤 #

1. 确保自研应用持有必要权限 #

在AndroidManifest.xml中添加以下权限：

<!-- BLE基础权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
<!-- Android 12+ 新增权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<!-- 位置权限（部分设备扫描需要） -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" android:maxSdkVersion="30" />

同时在代码中动态申请BLUETOOTH_SCAN、BLUETOOTH_CONNECT权限，避免权限缺失导致配对失败。

2. 跳过系统设置配对，通过应用直接触发BLE绑定 #

不要通过系统蓝牙设置发起配对，而是在自研应用中实现完整的BLE扫描、连接、绑定流程：

• 扫描到目标ESP32设备后，调用BluetoothDevice.createBond()触发绑定
• 监听ACTION_BOND_STATE_CHANGED广播，处理绑定状态变化：

  private final BroadcastReceiver bondStateReceiver = new BroadcastReceiver() {
      @Override
      public void onReceive(Context context, Intent intent) {
          String action = intent.getAction();
          if (BluetoothDevice.ACTION_BOND_STATE_CHANGED.equals(action)) {
              BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
              int bondState = intent.getIntExtra(BluetoothDevice.EXTRA_BOND_STATE, BluetoothDevice.ERROR);
              int prevBondState = intent.getIntExtra(BluetoothDevice.EXTRA_PREVIOUS_BOND_STATE, BluetoothDevice.ERROR);
              
              if (bondState == BluetoothDevice.BOND_BONDED) {
                  // 绑定成功，后续可进行GATT连接
              } else if (bondState == BluetoothDevice.BOND_FAILED) {
                  // 绑定失败，重试或提示用户
              }
          }
      }
  };
  

3. 统一ESP32的BLE配对参数 #

确保所有ESP32设备使用相同的配对模式（如ESP_BLE_SEC_MODE_ENC_MITM）和IO能力（如ESP_IO_CAP_NONE），避免因设备参数不一致导致系统识别异常：

// ESP32端BLE安全设置示例
esp_ble_gap_set_security_param(ESP_BLE_SM_AUTHEN_REQ_MODE, &auth_req, sizeof(auth_req));
esp_ble_gap_set_security_param(ESP_BLE_SM_IOCAP_MODE, &iocap, sizeof(iocap));
esp_ble_gap_set_security_param(ESP_BLE_SM_MAX_KEY_SIZE, &key_size, sizeof(key_size));

如果使用PIN码配对，确保所有设备使用相同的PIN，或者在应用中动态处理PIN输入（监听ACTION_PAIRING_REQUEST广播，调用setPin()方法）。

4. 清除已配对设备缓存（若之前配对过异常设备） #

进入Android系统设置-蓝牙-已配对设备，删除所有ESP32设备的配对记录，然后重启手机和ESP32设备，重新通过应用发起配对。

5. 处理Android 13的配对弹窗拦截 #

Android 13可能会阻止应用触发的配对弹窗，需确保应用在前台运行，并且在触发createBond()前，引导用户确认应用的蓝牙权限授权状态。

内容的提问来源于stack exchange，提问作者Ashley Uttley