React Native BLE PLX 在 Android 13 上的设备扫描问题分析与解决方案

问题背景

在 React Native BLE PLX 库（版本 3.2.1）的实际应用中，开发者遇到了一个特定于 Android 13（API 级别 33）设备的兼容性问题。该问题表现为：当应用以发布模式运行时，调用 startDeviceScan 方法会抛出 "BleManager was destroyed" 错误，而在开发模式下通过 Metro 运行时却能正常工作。

问题现象

开发者报告了以下关键现象：

1. 应用在 iOS、Android 11 和 Android 14 上运行正常
2. 在 Android 14 上通过 npx react-native run-android 运行时也正常工作
3. 仅在发布版本的 Android 13 设备上出现扫描失败
4. 即使尝试在扫描前重新初始化 BleManager，问题依然存在

技术分析

BleManager 生命周期管理

React Native BLE PLX 的核心 BleManager 实例需要在整个应用生命周期中保持单例状态。根据库的设计原则，BleManager 应该在 React 组件之外初始化一次，而不是在每次扫描时重新创建。

Android 13 权限变更

Android 13 引入了更严格的蓝牙权限控制：

• 新增了 BLUETOOTH_SCAN 运行时权限
• 对附近设备权限组进行了调整
• 后台位置权限要求更加严格

这些变更可能导致在特定条件下 BleManager 实例被系统回收或失效。

解决方案

正确的 BleManager 初始化方式

1. 单例模式：在应用启动时初始化一次 BleManager，并保持全局引用
2. 权限与初始化的顺序：
   • 对于 iOS：先初始化 BleManager，再请求权限
   • 对于 Android：先请求权限，确认授权后再初始化 BleManager

代码实现建议

// 在应用入口文件或专用服务模块中
let bleManagerInstance = null;

const getBleManager = () => {
  if (!bleManagerInstance) {
    bleManagerInstance = new BleManager();
  }
  return bleManagerInstance;
};

// 在组件中使用
const startScan = async () => {
  try {
    const manager = getBleManager();
    manager.startDeviceScan(/* 参数 */);
  } catch (error) {
    console.error('扫描失败:', error);
  }
};

权限处理最佳实践

1. 实现分平台的权限请求流程
2. 在 Android 上确保所有必要权限已授予：
   • BLUETOOTH_SCAN
   • BLUETOOTH_CONNECT
   • ACCESS_FINE_LOCATION（如果需要后台扫描）
3. 添加适当的错误处理和重试机制

深入理解

BleManager 销毁的原因

在 Android 13 上，当应用从后台返回前台时，系统可能会回收某些资源。如果 BleManager 没有正确保持引用，或者权限状态发生变化，可能导致实例失效。

发布模式与开发模式的差异

发布模式下：

• 代码经过优化和压缩
• 原生模块加载方式不同
• 权限检查更加严格 这些因素可能暴露了开发模式下隐藏的问题。

总结

React Native BLE PLX 在 Android 13 上的兼容性问题主要源于权限管理和 BleManager 生命周期的处理。通过遵循正确的初始化顺序、确保单例模式以及正确处理平台特定的权限要求，可以解决 "BleManager was destroyed" 错误。开发者应当特别注意 Android 13 引入的新权限模型，并在应用设计中考虑不同 Android 版本的行为差异。