Android蓝牙连接兼容性问题与解决方案

1. Android蓝牙连接兼容性问题深度解析

作为一名在移动开发领域深耕多年的工程师，我经常遇到开发者反馈蓝牙扫描返回空数组的问题。这个问题看似简单，实则涉及系统权限、设备兼容性、广播策略等多个技术层面。今天我就结合自己踩过的坑，系统梳理一下Android蓝牙连接兼容性问题的完整解决方案。

1.1 问题现象与本质分析

当使用react-native-ble-manager进行蓝牙设备扫描时，最令人困惑的情况莫过于：

javascript复制const peripherals = await BleManager.getDiscoveredPeripherals();
console.log(peripherals); // 输出: []

这种现象的本质是：扫描过程看似执行成功，但实际未能获取到任何设备信息。根据我的经验，这通常不是代码逻辑问题，而是由以下三类原因导致：

1. 权限问题（占比约60%）：新版本Android对蓝牙权限管理更加严格
2. 设备广播变化（占比约30%）：BLE设备厂商调整了广播策略
3. 系统策略变更（占比约10%）：Android/iOS系统更新引入的新限制

2. Android 12+蓝牙权限全解析

2.1 新权限要求详解

从Android 12（API级别31）开始，Google引入了更细粒度的蓝牙权限控制。如果你的targetSdkVersion ≥ 31，必须新增以下权限：

xml复制<!-- AndroidManifest.xml必须添加 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />

这些权限的作用分别是：

• BLUETOOTH_SCAN：允许应用发现和配对附近的蓝牙设备
• BLUETOOTH_CONNECT：允许应用连接已配对的蓝牙设备
• BLUETOOTH_ADVERTISE：允许设备自身作为蓝牙外设广播

重要提示：即使你只需要扫描而不需要连接，也必须同时申请SCAN和CONNECT权限，这是Android 12+的新要求。

2.2 兼容旧版本的权限策略

为了兼容Android 11及以下版本，还需要保留传统权限：

xml复制<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

这是因为在Android 11及以下版本中，蓝牙扫描仍然依赖于位置权限。这种双重权限策略需要特别注意。

2.3 运行时权限申请实战

仅声明权限还不够，必须在运行时动态申请。以下是React Native中的标准实现：

javascript复制import {PermissionsAndroid} from 'react-native';

async function requestBluetoothPermissions() {
  try {
    const granted = await PermissionsAndroid.requestMultiple([
      PermissionsAndroid.PERMISSIONS.BLUETOOTH_SCAN,
      PermissionsAndroid.PERMISSIONS.BLUETOOTH_CONNECT,
      PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION,
    ]);
    
    return (
      granted['android.permission.BLUETOOTH_SCAN'] === PermissionsAndroid.RESULTS.GRANTED &&
      granted['android.permission.BLUETOOTH_CONNECT'] === PermissionsAndroid.RESULTS.GRANTED
    );
  } catch (err) {
    console.warn(err);
    return false;
  }
}

调用时机建议：

javascript复制async function initBluetooth() {
  const hasPermission = await requestBluetoothPermissions();