React Native开发BLE应用的Android权限配置问题及崩溃排查

权限疑问解答 #

1. Android 10（SDK28/29）设备的蓝牙权限问题 #

运行Android 10的旧设备完全允许使用蓝牙功能，你当前配置中BLUETOOTH和BLUETOOTH_ADMIN权限的android:maxSdkVersion="30"设置是正确的——因为Android 11（SDK30）及以上系统引入了BLUETOOTH_CONNECT、BLUETOOTH_SCAN等细分权限，旧权限在SDK30及以上系统会被忽略，而SDK28/29设备会正常读取这两个旧权限，无需将maxSdkVersion设为低于30的值。

2. Android 13系统下BLE的权限要求 #

Android 13（SDK33）使用BLE需要以下权限：

• 扫描BLE设备：必须申请BLUETOOTH_SCAN权限，若扫描不需要关联位置信息，需添加android:usesPermissionFlags="neverForLocation"标记。
• 连接BLE设备：必须申请BLUETOOTH_CONNECT权限。
• 仅当应用需要通过BLE扫描获取位置信息时，才需要申请位置权限（ACCESS_COARSE_LOCATION/ACCESS_FINE_LOCATION）。

崩溃问题分析及修复建议 #

你的应用扫描BLE时崩溃，核心是权限配置和动态申请逻辑存在漏洞，具体修复点如下：

1. 清理冗余的AndroidManifest权限配置 #

你的配置中有无效或冗余权限，建议修改为：

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

<!-- 位置权限：仅当需要通过BLE获取位置时保留，否则可移除 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" android:maxSdkVersion="30" />

<!-- Android 11+的蓝牙细分权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:targetApi="s" />
<!-- 扫描权限：添加neverForLocation标记（若无需位置关联） -->
<uses-permission 
    android:name="android.permission.BLUETOOTH_SCAN" 
    android:usesPermissionFlags="neverForLocation" 
    tools:targetApi="s" />
<!-- 仅当应用需要被其他蓝牙设备发现时，才保留BLUETOOTH_ADVERTISE -->
<!-- <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" tools:targetApi="s" /> -->

• 移除无效的ACCESS_BLUETOOTH_ADMIN权限；
• 给BLUETOOTH_SCAN添加neverForLocation标记（若无需通过BLE获取位置）；
• 根据实际需求保留位置权限，不需要则直接删除。

2. 完善动态权限申请逻辑 #

你当前仅申请了BLUETOOTH_CONNECT，但扫描BLE需要根据系统版本申请对应权限，修改后的逻辑如下：

import { PermissionsAndroid, ToastAndroid, Platform } from 'react-native';

requestBlePermissions = async () => {
  let permissions = [];

  if (Platform.Version >= 31) {
    // Android 12+：直接申请蓝牙扫描、连接权限
    permissions = [
      PermissionsAndroid.PERMISSIONS.BLUETOOTH_SCAN,
      PermissionsAndroid.PERMISSIONS.BLUETOOTH_CONNECT
    ];
  } else if (Platform.Version >= 23 && Platform.Version <= 30) {
    // Android 6-10：蓝牙扫描依赖位置权限
    permissions = [
      PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION
    ];
  }

  const statuses = await PermissionsAndroid.requestMultiple(permissions);
  
  // 校验所有权限是否授予
  let allGranted = true;
  for (const perm of permissions) {
    if (statuses[perm] !== PermissionsAndroid.RESULTS.GRANTED) {
      allGranted = false;
      break;
    }
  }

  if (allGranted) {
    return true;
  } else {
    ToastAndroid.show(
      '蓝牙相关权限未授予，无法扫描设备',
      ToastAndroid.LONG
    );
    return false;
  }
};

• 针对不同Android版本申请对应权限：Android 12+直接申请蓝牙权限，Android 6-10申请位置权限；
• 使用requestMultiple批量申请，避免多次弹窗；
• 修正了原代码中权限类型与提示信息不匹配的问题。

3. 额外注意事项 #

• 确保使用的React Native蓝牙库（如react-native-ble-plx）版本适配目标Android SDK；
• 扫描BLE前必须先调用权限申请方法，确认全部权限授予后再执行扫描；
• 部分国产ROM（小米、华为等）有额外权限管控，需在系统设置中确认应用蓝牙权限已开启。

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