Android BLE：如何获取已连接设备的Gatt实例？

核心背景 #

开发BLE应用时，你已通过BluetoothManager.getConnectedDevices()实现设备连接状态检查，但需要获取已连接设备的Gatt实例来触发连接回调，以下针对你的三个疑问逐一解答：

1. 如何获取已连接设备的Gatt实例？

Android系统没有提供公开API直接获取已连接设备的Gatt实例，你必须自己在首次连接时缓存实例。可以用一个键值对集合（比如MutableMap），以设备地址为Key，存储调用connectGatt()返回的BluetoothGatt实例。后续判断设备已连接时，直接从缓存中读取即可。

修改后的代码示例：

// 类内或全局范围缓存Gatt实例，建议与BLE操作逻辑绑定
private val gattCache = mutableMapOf<String, BluetoothGatt>()

// 简化连接状态判断
fun isConnected(address: String): Boolean {
    val connectedDevices = bluetoothLEHandler.bluetoothManager.getConnectedDevices(BluetoothProfile.GATT)
    return connectedDevices.any { it.address == address }
}

// 首次连接时缓存实例
fun initDeviceConnection(device: BluetoothDevice, context: Context, gattCallback: BluetoothGattCallback) {
    val gatt = device.connectGatt(context, false, gattCallback)
    gattCache[device.address] = gatt
}

// 业务逻辑中使用
if (isConnected(device.address)) {
    val targetGatt = gattCache[device.address]
    targetGatt?.let {
        onConnectionEstablished(it)
    }
}

2. 是否应直接调用device.connectGatt(...)，无需先检查连接状态？

可以直接调用，但要注意两个关键点：

• 如果设备已经和当前应用保持连接（且未调用close()），重复调用connectGatt()会返回同一个Gatt实例，不会触发新的连接流程，但会替换之前注册的BluetoothGattCallback（如果传入了新的回调）。
• 如果设备是被其他应用连接的，当前应用调用connectGatt()会发起新的连接请求，可能因设备最大连接数限制失败，或需要用户授权。

因此建议先结合缓存的Gatt实例和系统连接状态做检查，避免不必要的回调覆盖或无效连接请求。

3. 是否应始终关闭之前的连接，即便很快需重连？

不需要。短时间内需要重复交互时，保留已有的Gatt实例更高效——关闭再重连会消耗额外的BLE资源，还会引入连接延迟。但出现以下情况必须调用BluetoothGatt.close()释放资源：

• 长时间不再使用设备（比如应用进入后台且无交互需求）
• Gatt实例出现异常（比如回调无响应、操作持续失败）
• 切换设备连接时

不及时关闭无效的Gatt实例可能导致内存泄漏，甚至影响后续的BLE操作。

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