Android BLE设备无法写入Descriptor启用通知问题求助

以下是针对该问题的具体排查和解决步骤：

1. 严格遵守BLE操作时序 #

BLE所有GATT操作都是异步的，必须等待前一个操作的回调确认完成后再执行下一个：

• 必须在onServicesDiscovered回调返回GATT_SUCCESS后，再调用enableNotifications，不能在连接成功后立刻发起descriptor写入
• 示例代码：

  override fun onServicesDiscovered(gatt: BluetoothGatt?, status: Int) {
      if (status == BluetoothGatt.GATT_SUCCESS) {
          // 先找到目标服务和特征值，再启用通知
          val targetService = gatt?.getService(UUID.fromString("你的服务UUID"))
          val targetChar = targetService?.getCharacteristic(UUID.fromString("你的特征UUID"))
          targetChar?.let { enableNotifications(gatt, it) }
      }
  }
  

2. 确认CCC Descriptor的正确性 #

• 确保CCC_DESCRIPTOR_UUID是标准值：00002902-0000-1000-8000-00805f9b34fb，多数BLE设备只支持这个标准UUID
• 检查descriptor是否支持写入操作，可在onServicesDiscovered中打印属性：

  descriptor?.let {
      Log.d("BLE", "Descriptor properties: ${it.properties}")
      // 需包含BluetoothGattDescriptor.PROPERTY_WRITE才可以写入
  }
  

3. 匹配特征值的通知/指示类型 #

有些设备要求用指示（Indication）而非通知（Notification），需根据特征值的属性选择对应启用值：

val enableValue = if (characteristic.properties and BluetoothGattCharacteristic.PROPERTY_NOTIFICATION != 0) {
    BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE
} else {
    BluetoothGattDescriptor.ENABLE_INDICATION_VALUE
}
descriptor.value = enableValue

4. 避免GATT操作并发 #

Android BLE一次只能处理一个GATT请求，若之前有读/写特征值、设置MTU等操作，必须等对应回调完成后再写入descriptor。可以用标志位或操作队列控制并发。

5. 尝试调整MTU大小 #

部分设备需要更大的MTU才能成功写入descriptor，可在连接成功后请求增大MTU：

override fun onConnectionStateChange(gatt: BluetoothGatt?, status: Int, newState: Int) {
    if (newState == BluetoothProfile.STATE_CONNECTED) {
        gatt?.requestMtu(512) // 请求MTU，等待onMtuChanged回调后再发现服务
    }
}

override fun onMtuChanged(gatt: BluetoothGatt?, mtu: Int, status: Int) {
    if (status == BluetoothGatt.GATT_SUCCESS) {
        gatt?.discoverServices()
    }
}

修正后的完整代码示例 #

private const val CCC_DESCRIPTOR_UUID = "00002902-0000-1000-8000-00805f9b34fb"

fun enableNotifications(gatt: BluetoothGatt, characteristic: BluetoothGattCharacteristic) {
    // 先开启系统层的通知开关
    val isNotificationEnabled = gatt.setCharacteristicNotification(characteristic, true)
    if (!isNotificationEnabled) {
        Log.e("BluetoothScanActivity", "Failed to enable notification switch for ${characteristic.uuid}")
        return
    }

    val descriptor = characteristic.getDescriptor(UUID.fromString(CCC_DESCRIPTOR_UUID)) ?: run {
        Log.e("BluetoothScanActivity", "CCC descriptor not found for ${characteristic.uuid}")
        return
    }

    // 根据特征属性选择正确的启用值
    val enableValue = if (characteristic.properties and BluetoothGattCharacteristic.PROPERTY_NOTIFICATION != 0) {
        BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE
    } else {
        BluetoothGattDescriptor.ENABLE_INDICATION_VALUE
    }

    descriptor.value = enableValue

    // 发起descriptor写入请求
    if (!gatt.writeDescriptor(descriptor)) {
        Log.e("BluetoothScanActivity", "Failed to start descriptor write for ${characteristic.uuid}")
    }
}

val bluetoothGattCallback = object : BluetoothGattCallback() {
    override fun onConnectionStateChange(gatt: BluetoothGatt?, status: Int, newState: Int) {
        when (newState) {
            BluetoothProfile.STATE_CONNECTED -> {
                gatt?.requestMtu(512) // 先调整MTU
            }
            BluetoothProfile.STATE_DISCONNECTED -> {
                // 处理断开逻辑
            }
        }
    }

    override fun onMtuChanged(gatt: BluetoothGatt?, mtu: Int, status: Int) {
        if (status == BluetoothGatt.GATT_SUCCESS) {
            gatt?.discoverServices() // MTU设置成功后发现服务
        }
    }

    override fun onServicesDiscovered(gatt: BluetoothGatt?, status: Int) {
        if (status == BluetoothGatt.GATT_SUCCESS) {
            // 替换为你的服务和特征UUID
            val targetService = gatt?.getService(UUID.fromString("YOUR_SERVICE_UUID"))
            val targetChar = targetService?.getCharacteristic(UUID.fromString("YOUR_CHARACTERISTIC_UUID"))
            targetChar?.let { enableNotifications(gatt, it) }
        }
    }

    override fun onDescriptorWrite(gatt: BluetoothGatt?, descriptor: BluetoothGattDescriptor?, status: Int) {
        if (status == BluetoothGatt.GATT_SUCCESS) {
            Log.d("BluetoothScanActivity", "Descriptor write success: ${descriptor?.characteristic?.uuid}")
        } else {
            Log.e("BluetoothScanActivity", "Descriptor write failed, status code: $status")
            // 偶发失败可尝试重试一次
            descriptor?.let { gatt?.writeDescriptor(it) }
        }
    }

    // 实现onCharacteristicChanged接收通知数据
    override fun onCharacteristicChanged(gatt: BluetoothGatt?, characteristic: BluetoothGattCharacteristic?) {
        characteristic?.value?.let { data ->
            Log.d("BluetoothScanActivity", "Received notification data: ${data.contentToString()}")
        }
    }
}

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