使用react-native-ble-manager遇TypeError：无法读取null的'enableBluetooth'属性

核心问题分析 #

这个错误本质是原生模块未正确初始化或未完成链接，导致JS层无法找到对应的原生方法实现，触发空指针访问。

分步解决办法 #

1. 确认库的安装与链接完整性 #

• 对于React Native 0.60+版本，自动链接默认生效，但需验证关键配置：
  • 检查android/app/build.gradle中是否存在implementation project(':react-native-ble-manager')（自动链接会自动添加）
  • 检查android/settings.gradle中是否包含：

    include ':react-native-ble-manager'
    project(':react-native-ble-manager').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-ble-manager/android')
    

• 若自动链接失效，执行手动链接：

  npx react-native link react-native-ble-manager
  

2. 修正JS层初始化时机 #

不要直接在组件顶层调用BleManager方法，需确保原生模块初始化完成后再执行操作，改用useEffect钩子：

import BleManager from 'react-native-ble-manager';
import { useEffect } from 'react';

export default function App() {
  useEffect(() => {
    // 先初始化BleManager
    BleManager.start({showAlert: false}).then(() => {
      console.log('BleManager初始化成功');
      // 初始化完成后调用蓝牙操作
      BleManager.enableBluetooth().then(() => {
        console.log('蓝牙开启成功');
      }).catch(err => {
        console.error('开启蓝牙失败:', err);
      });
    }).catch(err => {
      console.error('BleManager初始化失败:', err);
    });

    // 页面卸载时清理资源
    return () => {
      BleManager.stop();
    };
  }, []);

  return (
    // 你的组件内容
  );
}

3. 补全Android权限与动态申请 #

当前权限清单缺少Android 12+（API 31）所需的扫描权限，且静态权限无法满足运行时要求，需补充并动态申请：

• 完善AndroidManifest.xml权限：

  <uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
  <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <!-- 保留你已添加的其他权限 -->
  

• 在JS层动态申请必要权限（依赖react-native-permissions库）：

  import { request, PERMISSIONS, RESULTS } from 'react-native-permissions';
  
  useEffect(() => {
    const requestPermissions = async () => {
      const bleScanResult = await request(PERMISSIONS.ANDROID.BLUETOOTH_SCAN);
      const bleConnectResult = await request(PERMISSIONS.ANDROID.BLUETOOTH_CONNECT);
      const locationResult = await request(PERMISSIONS.ANDROID.ACCESS_FINE_LOCATION);
  
      if (bleScanResult === RESULTS.GRANTED && bleConnectResult === RESULTS.GRANTED && locationResult === RESULTS.GRANTED) {
        // 权限全部通过后初始化BleManager
        await BleManager.start({showAlert: false});
        await BleManager.enableBluetooth();
      }
    };
  
    requestPermissions();
  }, []);
  

4. 清理缓存并重建项目 #

• 清除Metro缓存：

  npx react-native start --reset-cache
  

• 清理Android构建缓存：

  cd android && ./gradlew clean && cd ..
  

• 重新编译运行：

  npx react-native run-android
  

替代开发方案 #

如果上述方案仍无法解决问题，可尝试以下成熟的蓝牙开发选项：

• react-native-ble-plx：社区活跃度高，文档完善，对Android 12+适配更友好，API设计简洁易用。
• 原生模块开发：若对性能或定制化要求极高，可直接基于Android原生Bluetooth LE API开发模块，再通过React Native桥接实现JS层调用。

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