Android中setCharacteristicNotification()调用后未触发回调问题求助

我之前也碰到过一模一样的坑！折腾了好几天才找到根源，给你列几个关键排查点，按顺序试应该能解决：

• 必须写入Client Characteristic Configuration Descriptor
  这是最容易漏掉的核心步骤！setCharacteristicNotification()只是开启本地App的监听开关，但还需要主动向设备的Descriptor写入开启指令，设备才会真正推送通知。你需要找到目标Characteristic对应的Descriptor（固定UUID为00002902-0000-1000-8000-00805f9b34fb），然后写入通知/指示开启值，并且要等待onDescriptorWrite回调确认写入成功：

  // 获取对应的Descriptor
  BluetoothGattDescriptor descriptor = characteristic.getDescriptor(
      UUID.fromString("00002902-0000-1000-8000-00805f9b34fb")
  );
  // 根据设备支持的类型选择，NOTIFICATION或INDICATION
  descriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE);
  // 写入Descriptor，必须等待onDescriptorWrite回调确认
  gatt.writeDescriptor(descriptor);
  

  注意：如果设备用的是INDICATION（需要App回复确认的通知类型），要换成BluetoothGattDescriptor.ENABLE_INDICATION_VALUE。

• 确认BluetoothGattCallback实例的一致性
  检查你调用setCharacteristicNotification时用的BluetoothGatt对象，和调用connectGatt时传入的BluetoothGattCallback是不是同一个实例？如果Callback被意外回收（比如匿名内部类在Activity销毁前没处理），或者Gatt对象被重新创建了，都会导致回调收不到。

• 验证Characteristic的属性
  确保目标Characteristic的属性包含PROPERTY_NOTIFY或PROPERTY_INDICATION，可以用以下代码输出属性值：

  int properties = characteristic.getProperties();
  Log.d(TAG, "Characteristic properties: " + properties);
  

  如果没有对应的属性，就算订阅了设备也不会推送数据。

• 检查蓝牙连接状态
  在onConnectionStateChange回调里打印连接状态，确认订阅通知时设备处于BluetoothProfile.STATE_CONNECTED状态，没有出现断开重连的情况。有时候连接看似正常，但实际已经处于不稳定状态，会导致通知无法送达。

• 日志深度排查
  除了App自身的日志，建议用adb抓取系统蓝牙日志，能看到更详细的错误信息：

  adb logcat -s BluetoothGatt BluetoothAdapter
  

  比如Descriptor写入失败、通知发送时的异常都会在这里体现。

内容的提问来源于stack exchange，提问作者Thomas.O