React Native Ble-Plx扫描报错[BleError: Cannot start scanning operation]求助

问题背景 #

基于Android平台的react-native-cli室内iBeacon导航项目，使用react-native-ble-plx库。Android 5.0设备运行正常，但Android 11及以上设备，即便获取了位置权限，仍因蓝牙扫描、连接权限问题触发[BleError: Cannot start scanning operation]报错。

解决方案 #

一、修正 AndroidManifest.xml 权限配置 #

Android 11（API 30）及以上版本对蓝牙权限做了拆分，需针对不同版本配置对应权限，避免权限冲突：

<!-- 适配 Android 10 及以下版本的旧蓝牙权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />

<!-- Android 11+ 新增蓝牙权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

<!-- iBeacon 扫描依赖位置权限，适配全版本 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- Android 10+ 后台扫描需添加后台位置权限 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" android:minSdkVersion="29" />

<uses-feature android:name="android.hardware.bluetooth" android:required="true"/>
<uses-feature android:name="android.hardware.bluetooth_le" android:required="true" />

说明：给旧蓝牙权限添加android:maxSdkVersion="30"，避免在Android 11+系统中与新权限冲突；后台位置权限仅在Android 10+需要，用于后台持续扫描iBeacon。

二、修复权限请求逻辑 #

原权限请求顺序错误，且未针对Android版本区分权限集合，改为批量请求+版本适配逻辑：

const requestPermissions = async () => {
  if (Platform.OS !== 'android') return Promise.resolve(true);

  const androidVersion = Platform.Version;
  const permissionsToRequest = [];

  // 所有版本扫描iBeacon都需要精确定位权限
  permissionsToRequest.push(PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION);

  // Android 10+ 后台扫描需后台位置权限
  if (androidVersion >= 29) {
    permissionsToRequest.push(PermissionsAndroid.PERMISSIONS.ACCESS_BACKGROUND_LOCATION);
  }

  // Android 12+ 需单独申请蓝牙扫描、连接权限
  if (androidVersion >= 31) {
    permissionsToRequest.push(
      PermissionsAndroid.PERMISSIONS.BLUETOOTH_SCAN,
      PermissionsAndroid.PERMISSIONS.BLUETOOTH_CONNECT
    );
  }

  // 批量请求权限，避免多次弹窗
  const result = await PermissionsAndroid.requestMultiple(permissionsToRequest);

  // 校验所有权限是否授权
  const allGranted = permissionsToRequest.every(perm => result[perm] === PermissionsAndroid.RESULTS.GRANTED);
  
  if (allGranted) {
    console.log('所有权限已授权');
    return true;
  } else {
    console.warn('部分权限未授权，无法正常扫描蓝牙设备');
    return false;
  }
};

说明：使用requestMultiple批量请求权限，减少用户弹窗次数；根据Android版本动态添加所需权限，确保权限请求的准确性。

三、优化扫描代码 #

原扫描代码存在重复扫描、错误处理模糊、无资源清理逻辑等问题，优化后如下：

import { debounce } from 'lodash';
import { Linking } from 'react-native';

// Scanning Operations
const scanForDevices = useCallback(() => {
  // 停止之前的扫描任务，避免重复扫描
  manager.stopDeviceScan();

  const performScan = () => {
    manager.startDeviceScan(null, { allowDuplicates: false }, (error, device) => {
      if (error) {
        console.error('扫描错误:', error);
        manager.stopDeviceScan();
        
        // 区分权限错误与其他蓝牙错误
        if (error.message.includes('permission')) {
          Alert.alert(
            '权限缺失',
            '请前往设置开启蓝牙和位置权限',
            [{ text: '去设置', onPress: () => Linking.openSettings() }, { text: '取消' }],
            { cancelable: true }
          );
        } else {
          Alert.alert(
            '扫描失败',
            '请检查蓝牙是否开启后重试',
            [{ text: '确定' }],
            { cancelable: false }
          );
        }
        return;
      }

      if (!device || device.localName !== defaultDeviceName) return;

      try {
        const base64 = RNFetchBlob.base64;
        const advertisingData = stringToBytes(base64.decode(device.manufacturerData));
        const rssi = device.rssi;
        const major = advertisingData[21];
        const minor = advertisingData[23];

        setBleData(rssi, major, minor);
        console.log('匹配到目标设备:', matchedDataRef.current);
      } catch (parseError) {
        console.error('广告数据解析失败:', parseError);
      }
    });
  };

  // 防抖处理，短时间内仅执行一次扫描
  const debouncedScan = debounce(performScan, 1500);
  debouncedScan();

  // 组件卸载时清理扫描任务与防抖函数
  return () => {
    manager.stopDeviceScan();
    debouncedScan.cancel();
  };
}, [setBleData, manager, defaultDeviceName]);

说明：

1. 每次扫描前停止旧任务，避免多扫描实例冲突
2. 添加allowDuplicates: false过滤重复设备回调，提升性能
3. 区分权限错误与蓝牙硬件错误，给出针对性提示
4. 解析广告数据时添加try-catch，防止数据格式异常导致崩溃
5. 组件卸载时清理资源，避免内存泄漏

额外检查项 #

1. 扫描前检查蓝牙状态：

const checkBluetoothState = async () => {
  const state = await manager.state();
  return state === 'PoweredOn';
};

// 在调用scanForDevices前执行
const isBluetoothEnabled = await checkBluetoothState();
if (!isBluetoothEnabled) {
  Alert.alert('提示', '请先开启蓝牙');
  return;
}

2. 确保react-native-ble-plx库为最新版本，旧版本可能存在Android 11+权限适配问题
3. 若应用需后台持续扫描，需在Manifest中声明前台服务类型：

<service
  android:name="com.reactnativecommunity.bluetoothle.BleManagerService"
  android:foregroundServiceType="location" />

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