React Native iOS连接经典蓝牙设备使用react-native-bluetooth-serial报错如何解决

你当前使用的react-native-bluetooth-serial库仅支持Android端经典蓝牙，iOS端该库底层调用的是负责低功耗蓝牙（BLE）的CoreBluetooth框架，完全不支持经典蓝牙设备的扫描、连接操作，你看到的[CoreBluetooth] XPC connection invalid以及外设列表为空的日志，就是调用CoreBluetooth操作经典蓝牙设备时的框架不匹配报错。

iOS系统对经典蓝牙设备的连接有严格限制，必须满足两个前提：

• 目标蓝牙设备已经过苹果MFi（Made for iPhone/iPad/iPod）认证
• 项目中配置了蓝牙设备厂商提供的对应Accessory Protocol Strings协议字符串

直接更换为双端都支持经典蓝牙的react-native-bluetooth-classic库即可，该库iOS端基于External Accessory框架实现，专门适配经典蓝牙场景。

集成操作步骤 #

1. 卸载旧的不兼容库

npm uninstall react-native-bluetooth-serial --save

2. 安装目标库

npm install react-native-bluetooth-classic --save

3. iOS端额外配置

• 打开Xcode项目，在Info.plist文件中添加如下配置：
  • 权限配置：添加NSBluetoothAlwaysUsageDescription字段，值为App使用蓝牙的说明文案，比如「需要使用蓝牙连接外设」
  • 协议配置：添加UISupportedExternalAccessoryProtocols数组字段，将蓝牙设备厂商提供的协议字符串填入数组
• 打开项目的Signing & Capabilities标签页，开启External Accessory communication开关

4. 基础连接示例代码

import RNBluetoothClassic from 'react-native-bluetooth-classic';

// 连接设备逻辑
const connectClassicDevice = async () => {
  // 先请求蓝牙权限
  const hasPermission = await RNBluetoothClassic.requestPermission();
  if (!hasPermission) return;

  // iOS仅支持获取已配对的经典蓝牙设备，未配对设备需要先到系统蓝牙设置中完成配对
  const bondedDevices = await RNBluetoothClassic.getBondedDevices();
  const target = bondedDevices.find(device => device.name === '你的目标蓝牙设备名');
  
  if (target) {
    const connectResult = await target.connect();
    if (connectResult) {
      console.log('设备连接成功，可开始数据传输');
    }
  }
}

如果你的设备实际是BLE低功耗蓝牙，只是误归类为经典蓝牙，可以直接使用react-native-ble-plx库适配，该库完全兼容iOS的CoreBluetooth框架，不会出现当前报错。

• 未经过MFi认证的经典蓝牙设备，无法在非越狱的iOS设备上完成应用层连接
• iOS不支持应用内扫描未配对的经典蓝牙设备，必须先引导用户到系统蓝牙设置中配对目标设备之后，应用才能获取到设备列表

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