Android 4.4与5中BLE onCharacteristicChanged未触发问题求助

这是个非常典型的Android BLE版本兼容性坑，毕竟4.4（API 19）是Android正式支持BLE的起始版本，5.x的BLE栈也还存在不少未完善的细节，结合你使用的nRF51822模块，我整理了几个高概率的解决方向：

1. 严格遵循Android 4.4/5.x的通知启用流程，拒绝“固定延迟” #

Android 4.4+启用BLE通知必须完成两步：调用setCharacteristicNotification，再异步写入CCCD描述符，而且必须等onDescriptorWrite回调确认写入成功后，才能执行writeCharacteristic——固定延迟完全不可靠，不同设备的BLE处理速度差异极大。

示例代码参考：

// 标准CCCD UUID
UUID CCCD_UUID = UUID.fromString("00002902-0000-1000-8000-00805f9b34fb");
BluetoothGattDescriptor cccdDescriptor = targetCharacteristic.getDescriptor(CCCD_UUID);

if (cccdDescriptor != null) {
    // 启用通知的标准值
    cccdDescriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE);
    // 异步写入，等待onDescriptorWrite回调确认成功
    mBluetoothGatt.writeDescriptor(cccdDescriptor);
}

在onDescriptorWrite回调里判断写入结果，成功后再执行指令写入：

@Override
public void onDescriptorWrite(BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status) {
    super.onDescriptorWrite(gatt, descriptor, status);
    if (status == BluetoothGatt.GATT_SUCCESS) {
        // 到这里才真正确认通知启用完成，再执行writeCharacteristic
        writeYourCommandToCharacteristic();
    } else {
        // 处理CCCD写入失败的情况，比如重试
    }
}

2. 检查Write操作类型与nRF51822固件的匹配性 #

nRF51822的固件对Write操作类型可能有要求：

• 如果你的模块固件需要带响应的Write操作才能触发Notification，那Android端必须使用BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT（这是默认值，但部分场景可能被误设为WRITE_TYPE_NO_RESPONSE）
• 可以先用nRF Connect工具手动发送相同指令，看是否能收到Notification，先排除模块固件本身的问题。

3. 修复Android 5.x的BLE连接稳定性问题 #

Android 5.x的BLE栈存在连接参数协商的已知问题，可能导致数据传输中断：

• 连接成功后，可以尝试主动设置高优先级连接参数：

  mBluetoothGatt.requestConnectionPriority(BluetoothGatt.CONNECTION_PRIORITY_HIGH);
  

• 确保所有BLE操作（服务发现、通知启用、指令写入）都在onConnectionStateChange回调确认连接状态为STATE_CONNECTED后再执行，不要提前触发。

4. 从Logcat日志中抓关键线索 #

重点排查这些日志关键词：

• BluetoothGatt相关错误：比如writeCharacteristic failed、onDescriptorWrite error，确认操作是否真的执行成功
• Notification相关日志：是否有Notification enabled或Characteristic changed的输出，判断是Android端没收到还是模块没发送
• 如果日志显示writeCharacteristic成功但无onCharacteristicChanged，大概率是模块未触发通知，需要检查固件逻辑或指令格式。

5. 绝对避免BLE操作并发 #

Android BLE栈是单线程处理的，4.4/5.x中如果同时发起多个操作（比如通知启用未完成就写指令），会导致操作被丢弃或顺序混乱——必须保证每个BLE操作都在前一个操作的回调（onDescriptorWrite/onCharacteristicWrite）完成后再执行下一个。

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