react-native-ble-plx库中Android 14 GATT读取异常问题解析

问题背景

在使用react-native-ble-plx库进行蓝牙低功耗(BLE)开发时，开发者在Android 14设备上遇到了一个特殊的GATT异常。当尝试读取某个特征值时，系统返回了"Operation was rejected"错误，并伴随GATT异常信息。这类问题在BLE开发中并不罕见，但需要开发者对BLE协议和Android系统有深入理解才能有效解决。

错误现象分析

错误信息显示为：

"message":"Operation was rejected","errorCode":4,"attErrorCode":null,"iosErrorCode":null,"androidErrorCode":null,"reason":"GATT exception from MAC address A0:B7:65:15:51:46, with type BleGattOperation{description='CHARACTERISTIC_READ'}","name":"BleError"

这个错误表明在尝试执行CHARACTERISTIC_READ操作时，设备拒绝了该请求。值得注意的是，错误中没有提供具体的ATT错误码，这增加了排查难度。

可能的原因

根据经验，此类问题通常由以下几个因素导致：

1. 特征值权限问题：目标特征值可能没有配置读取权限。BLE设备上的每个特征值都有特定的权限设置，如果特征值被配置为只写或无权限，读取操作自然会被拒绝。

2. 设备未就绪：在建立连接后立即尝试读取特征值，此时设备可能尚未完全初始化。BLE连接建立后，设备需要一定时间准备服务发现和特征值枚举。

3. MTU大小不匹配：虽然代码中设置了requestMTU为517，但实际协商的MTU可能较小，导致读取操作失败。

4. 固件问题：蓝牙外设的固件可能存在缺陷，未能正确处理读取请求。

5. Android系统限制：Android 14可能引入了新的蓝牙权限控制或行为变更。

解决方案

1. 验证特征值权限

使用专业的BLE调试工具（如nRF Connect）连接设备，检查目标特征值的属性。确认该特征值是否确实支持读取操作。特征值的权限通常在设备固件中定义，无法通过客户端代码修改。

2. 添加适当的延迟

在发现服务后立即读取特征值可能会导致失败。建议添加合理的延迟或等待特定事件：

await deviceConnection.discoverAllServicesAndCharacteristics();
// 添加适当延迟
await new Promise(resolve => setTimeout(resolve, 500));
// 然后再尝试读取特征值

3. 实现重试机制

蓝牙操作具有不确定性，实现自动重试可以提高可靠性：

const maxRetries = 3;
let retryCount = 0;

async function readWithRetry() {
  try {
    const characteristic = await deviceConnection.readCharacteristicForService(
      SERVICE_UUID, 
      CHATACTERISTICS_UUID
    );
    return characteristic;
  } catch (error) {
    if (retryCount < maxRetries) {
      retryCount++;
      await new Promise(resolve => setTimeout(resolve, 300));
      return readWithRetry();
    }
    throw error;
  }
}

4. 检查MTU协商结果

虽然设置了较大的MTU，但实际协商结果可能较小。可以在连接后检查实际MTU：

const mtu = await deviceConnection.mtu();
console.log('Negotiated MTU:', mtu);

5. 固件更新

如果可能，检查蓝牙设备是否有可用的固件更新。许多BLE设备厂商会通过固件更新修复通信问题。

最佳实践建议

1. 连接稳定性：确保设备已完全连接并发现所有服务后再进行操作。

2. 错误处理：实现全面的错误处理逻辑，考虑各种可能的失败场景。

3. 日志记录：详细记录BLE操作流程，便于问题排查。

4. 设备兼容性测试：在不同Android版本和设备上进行充分测试。

5. 权限检查：确保应用已获取所有必要的蓝牙权限。

总结

Android BLE开发中的GATT异常通常需要从多个角度分析。react-native-ble-plx库提供了良好的抽象层，但底层仍受限于Android系统的蓝牙栈实现和设备固件。遇到类似问题时，建议采用分步排查法：先确认特征值权限，再检查时序问题，最后考虑设备和系统因素。通过合理的延迟、重试机制和全面的错误处理，可以显著提高BLE通信的可靠性。