安卓开发：已连接BLE设备且GATT服务发现成功但无法接收数据的问题问询

结论先放前面：完全不需要额外添加广播接收器、广播更新逻辑，你收不到设备数据的核心原因是代码里多处BLE操作存在硬伤，根本没有成功完成notify订阅流程

代码现存的核心问题 #

• 最致命的UUID比较逻辑错误：BluetoothGattService、BluetoothGattCharacteristic的getUuid()方法返回的是java.util.UUID类型对象，你直接拿它和字符串做equals比较，结果永远为false，循环会直接跳过目标服务/特征值，后续订阅逻辑根本没执行。
• 特征值属性判断逻辑错误：你用了位或运算(charaProp | BluetoothGattCharacteristic.PROPERTY_NOTIFY) > 0做判断，不管特征值实际有没有notify属性，这个判断永远为真，完全起不到校验作用。
• 描述符查找逻辑错误：BLE规范中notify订阅对应的配置描述符（CCCD）是固定UUID的，你用自定义的BTMODULEUUID查找描述符，大概率拿到null值，后续setValue操作直接空指针；就算不崩溃，写入的也不是设备认可的描述符，订阅必然失败。
• GATT指令没有遵守队列规则：你已经写好了带排队、重试的命令队列机制，但是在setCharacteristicNotification中直接调用mGatt.writeDescriptor()发送写指令，没有走队列排队——安卓BLE的特性是同一时间只能处理一个GATT指令，上一个指令没收到系统回调就发下一个，系统会直接静默丢包。
• 缺失必要回调：你没有重写onDescriptorWrite回调，写描述符完成后没有触发completedCommand()释放队列锁，后续所有GATT操作都会永久卡住。

具体修正步骤 #

1. 提前定义所有UUID常量，避免字符串和UUID对象直接比较：

   // 目标服务UUID
   private static final UUID TARGET_SERVICE_UUID = UUID.fromString("49535343-FE7D-4AE5-8FA9-9FAFD205E455");
   // 目标特征值UUID
   private static final UUID TARGET_CHAR_UUID = UUID.fromString("49535343-1E4D-4BD9-BA61-23C647249616");
   // 蓝牙规范固定的CCCD描述符UUID
   private static final UUID CCCD_DESCRIPTOR_UUID = UUID.fromString("00002902-0000-1000-8000-00805f9b34fb");
   

   循环遍历的时候改成UUID对象之间的比较：

   if (!TARGET_SERVICE_UUID.equals(service.getUuid())) continue;
   // 特征值判断同理
   if (!TARGET_CHAR_UUID.equals(gattCharacteristic.getUuid())) continue;
   

2. 修正特征值属性判断逻辑，用位与运算校验：

   int charaProp = gattCharacteristic.getProperties();
   if ((charaProp & BluetoothGattCharacteristic.PROPERTY_NOTIFY) > 0) {
       setCharacteristicNotification(gattCharacteristic, true);
       Log.w(TAG, "已找到支持notify的特征值，开始订阅");
   } else {
       Log.w(TAG, "当前特征值不支持notify");
   }
   

3. 修正setCharacteristicNotification的实现，把写描述符操作加入队列：

   public void setCharacteristicNotification(BluetoothGattCharacteristic characteristic, boolean enabled) {
       if (bluetoothAdapter == null || mGatt == null) {
           Log.w(TAG, "蓝牙未初始化");
           return;
       }
       // 先开启本地的回调开关
       mGatt.setCharacteristicNotification(characteristic, enabled);
       
       // 查找固定的CCCD描述符
       BluetoothGattDescriptor descriptor = characteristic.getDescriptor(CCCD_DESCRIPTOR_UUID);
       if (descriptor == null) {
           Log.e(TAG, "未找到CCCD描述符，无法订阅");
           return;
       }
       // 写入订阅标识值
       descriptor.setValue(enabled ? BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE : BluetoothGattDescriptor.DISABLE_NOTIFICATION_VALUE);
       // 把写描述符操作丢入命令队列排队执行
       commandQueue.add(() -> {
           if (!mGatt.writeDescriptor(descriptor)) {
               Log.e(TAG, "写描述符指令发送失败");
               completedCommand();
           }
       });
       nextCommand();
   }
   

4. 补写onDescriptorWrite回调，及时释放队列锁：

   @Override
   public void onDescriptorWrite(BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status) {
       Log.i(TAG, "描述符写入完成，状态：" + status);
       // 不管成功失败，都要推进队列
       completedCommand();
   }
   

常见排查点 #

• 确认设备端逻辑：部分BLE设备需要你往对应的写入特征值发一段约定的指令，才会主动通过notify上报数据，不是订阅了就一定会发数据。
• 确认安卓12+的运行时权限：需要动态申请BLUETOOTH_SCAN、BLUETOOTH_CONNECT权限，否则所有BLE操作都会静默失败。
• 确认没有额外的连接逻辑把gatt对象置空：连接断开的时候及时把mGatt置null，避免无效操作。

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