Android Gatt：如何识别回调响应对应的请求？

一、如何区分读写回调对应的请求 #

Android 的 BluetoothGatt 没有提供直接传入请求 ID 的机制，但可以通过两种方式实现请求与回调的关联：

1. 给 Characteristic 附加自定义标记 #

每个 BluetoothGattCharacteristic 对象支持通过 setTag() 方法添加自定义标记，你可以在发起请求前将请求的唯一标识（比如序号、业务类型）存入标记，回调触发时取出匹配：

// 发起读请求时标记请求
BluetoothGattCharacteristic chara = getTargetCharacteristic();
chara.setTag("read_temp_sensor"); // 自定义请求标识
gatt.readCharacteristic(chara);

// 回调中识别请求
@Override
public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
    String requestTag = (String) characteristic.getTag();
    if ("read_temp_sensor".equals(requestTag)) {
        // 处理该请求的读取结果
    }
}

2. 维护本地请求队列映射 #

如果是批量请求场景，可以维护一个本地队列，记录每个请求对应的 Characteristic 和业务元数据：

• 每次发起读写请求时，将该 Characteristic 与请求信息（比如序号、待写入值）存入队列
• 回调触发时，遍历队列找到匹配的 Characteristic，取出对应的请求信息处理，处理完成后从队列移除该条目

二、关于批量请求的关键注意点 #

Android BLE 的 BluetoothGatt 不支持并发发起多个读写请求，必须等待上一个请求的回调（成功或失败）返回后，才能发起下一个请求。

这是由 BLE 协议的单通道特性决定的，底层会序列化处理请求。如果强行并发发起，会导致请求顺序混乱、回调匹配错误，甚至引发连接断开。这和你类比的“等邮件确认再发新邮件”逻辑一致，是 BLE 通信的固有约束。

三、写入场景的错误定位方案 #

针对你提到的写入数值后出现失败的场景，按串行请求逻辑即可精准定位失败请求：

1. 维护一个待写入的队列，每次仅发起队列头部的请求
2. 回调返回成功时，移除队首元素并发起下一个请求；返回失败时，直接获取队首元素就是未成功处理的请求，可选择重试或记录错误

示例逻辑：

private Queue<Integer> writeQueue = new LinkedList<>(Arrays.asList(1, 3, 4, 2, 7));
private BluetoothGattCharacteristic targetChara;

// 启动写入流程
private void startNextWrite() {
    if (!writeQueue.isEmpty()) {
        int value = writeQueue.peek();
        targetChara.setValue(value, BluetoothGattCharacteristic.FORMAT_UINT8, 0);
        gatt.writeCharacteristic(targetChara);
    }
}

// 写入回调处理
@Override
public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
    if (status == BluetoothGatt.GATT_SUCCESS) {
        writeQueue.poll(); // 移除已成功的请求
    } else {
        int failedValue = writeQueue.peek();
        // 记录失败的数值：failedValue
    }
    // 发起下一个写入请求
    startNextWrite();
}

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