在Expo+React Native中使用react-native-ble-plx创建BleManager失败求助

一、解决Cannot read property 'createClient' of null错误 #

这个错误本质是react-native-ble-plx的原生模块未正确加载，导致初始化BleManager时调用内部方法失败，以下是针对性解决步骤：

1. 确认Expo运行环境
   react-native-ble-plx不支持Expo的Managed Workflow（纯JS环境），必须切换到Bare Workflow。如果你的项目是Managed模式，执行expo prebuild生成原生项目文件，之后按原生项目流程配置。

2. 重新安装依赖并清理缓存

• 删除node_modules、package-lock.json（或yarn.lock）
• 执行npm install（或yarn install）重新安装依赖
• 清理Metro缓存：npx react-native start --reset-cache

3. 检查原生端配置

• iOS：进入ios目录执行pod install，确保Podfile中已包含react-native-ble-plx的依赖；同时在Info.plist中添加BLE相关权限（NSBluetoothAlwaysUsageDescription、NSBluetoothPeripheralUsageDescription）
• Android：检查android/settings.gradle是否添加了react-native-ble-plx的引用，android/app/build.gradle的依赖列表是否包含该库；在AndroidManifest.xml中添加<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />、<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />等权限

4. 调整BleManager初始化时机
   避免在useMemo中直接初始化，改用useEffect延迟到组件挂载后创建，同时记得销毁资源：

import { useState, useEffect } from 'react';
import { BleManager } from 'react-native-ble-plx';

// 在组件内
const [bleManager, setBleManager] = useState(null);

useEffect(() => {
  const manager = new BleManager();
  setBleManager(manager);
  // 组件卸载时销毁管理器
  return () => manager.destroy();
}, []);

二、react-native-ble-plx可用性与替代库 #

• 可用性：react-native-ble-plx目前仍处于维护状态，可正常用于React Native原生项目（Bare Workflow），但对Expo Managed环境支持有限，社区仍有不少开发者在使用。
• 替代库：
  • Expo Bluetooth Low Energy：Expo官方提供的BLE库，完美支持Managed Workflow，API简洁易上手，适合Expo生态项目。
  • react-native-ble-manager：社区活跃度较高的BLE库，支持iOS/Android双平台，功能全面，需原生配置。
  • react-native-peripheral：支持BLE中心模式与外设模式，适合需要模拟BLE设备的复杂场景。

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