React Native实例化BleManager报错：createClient为null

这个错误本质是原生模块未正确加载或初始化，以下是针对性的解决步骤：

1. 验证依赖安装与原生链接 #

• 确保已正确安装库：

  # npm
  npm install react-native-ble-plx
  # 或 yarn
  yarn add react-native-ble-plx
  

• iOS端：进入ios目录执行pod安装，然后重新编译

  cd ios && pod install && cd ..
  npx react-native run-ios
  

• Android端：
  • 检查android/app/build.gradle中是否自动添加了依赖（React Native 0.60+自动链接，若没有则手动添加）：

    dependencies {
      implementation project(':react-native-ble-plx')
    }
    

  • 重启Android项目，清理缓存后重新编译：

    cd android && ./gradlew clean && cd ..
    npx react-native run-android
    

2. 修正初始化时机 #

不要在组件外部直接实例化BleManager，应该在组件内部的生命周期钩子（如useEffect）中创建实例，确保原生模块已加载完成：

import React, {useEffect, useRef} from 'react'
import { View, Text } from 'react-native'
import { BleManager } from 'react-native-ble-plx';

const EspConnection = ({navigation}) => {
  // 使用useRef保存manager实例，避免重复创建
  const managerRef = useRef(null);

  useEffect(() => {
    // 在组件挂载时初始化BleManager
    managerRef.current = new BleManager();
    
    // 组件卸载时销毁manager，释放资源
    return () => {
      managerRef.current?.destroy();
    };
  }, []);

  return (
      <View>
          <Text>Salve vei</Text>
      </View>
  )
}

export {EspConnection}

3. 检查权限配置 #

BLE功能需要对应的系统权限，缺失权限也可能导致模块初始化失败：

• iOS：在Info.plist中添加以下权限：

  <key>NSBluetoothAlwaysUsageDescription</key>
  <string>需要蓝牙权限连接设备</string>
  <key>NSBluetoothPeripheralUsageDescription</key>
  <string>需要蓝牙权限连接设备</string>
  

• Android：在AndroidManifest.xml中添加权限（根据系统版本调整）：

  <!-- Android 11及以下 -->
  <uses-permission android:name="android.permission.BLUETOOTH" />
  <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  
  <!-- Android 12+ -->
  <uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
  <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
  

4. 使用真机测试 #

BLE功能在模拟器上通常无法正常工作，建议使用iOS/Android真机进行测试。

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