Android 12及以下设备BLE GattCallback.onCharacteristicChanged不触发求助

1. 兼容新旧版回调实现 #

尽管API33+弃用了旧版onCharacteristicChanged，但同时实现新旧两个回调方法，可覆盖Android 11/12默认蓝牙栈的兼容性问题——在不开启Gabeldorsche栈的情况下，旧版回调可能会被系统调用：

// 旧版回调（兼容Android < 33）
@Override
public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {
    super.onCharacteristicChanged(gatt, characteristic);
    handleNotificationData(characteristic);
}

// 新版回调（适配Android >= 33）
@RequiresApi(api = Build.VERSION_CODES.TIRAMISU)
@Override
public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, byte[] value) {
    super.onCharacteristicChanged(gatt, characteristic, value);
    characteristic.setValue(value);
    handleNotificationData(characteristic);
}

// 统一处理通知数据的方法
private void handleNotificationData(BluetoothGattCharacteristic characteristic) {
    // 此处编写你的通知数据解析逻辑
}

2. 严格校验CCCD写入流程 #

部分Android 11/12设备对CCCD写入的格式和时序要求严格，需确保：

• 使用系统标准的启用通知值：BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE，禁止自定义字节数组
• 必须在onDescriptorWrite回调确认写入成功后，再发送后续命令，避免时序冲突

public boolean enableCharacteristicNotification(BluetoothGatt gatt, BluetoothGattCharacteristic targetChar) {
    if (gatt == null || targetChar == null) return false;

    // 开启特征通知开关
    boolean result = gatt.setCharacteristicNotification(targetChar, true);
    // 获取CCCD描述符
    BluetoothGattDescriptor cccd = targetChar.getDescriptor(UUID.fromString("00002902-0000-1000-8000-00805f9b34fb"));
    if (cccd != null) {
        cccd.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE);
        // 写入CCCD
        result &= gatt.writeDescriptor(cccd);
    }
    return result;
}

3. 优化连接上下文 #

在Service中调用connectToGatt时，必须使用ApplicationContext，避免因Activity上下文销毁导致的回调丢失：

BluetoothGatt gatt = device.connectGatt(getApplicationContext(), false, mGattCallback);

4. 重置蓝牙栈状态 #

部分Android 11/12设备的默认蓝牙栈存在状态异常，可在连接前重置蓝牙：

BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
if (adapter.isEnabled()) {
    adapter.disable();
    // 等待2秒后重新开启蓝牙
    new Handler(Looper.getMainLooper()).postDelayed(() -> {
        adapter.enable();
        // 蓝牙开启后执行连接逻辑
    }, 2000);
}

5. 验证设备端特征属性 #

确认BLE设备的目标特征已开启通知属性，可通过代码校验：

if ((targetChar.getProperties() & BluetoothGattCharacteristic.PROPERTY_NOTIFY) != 0) {
    // 特征支持通知，继续流程
} else {
    // 设备端特征未配置通知属性，需排查硬件配置
}

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