维护旧版Android应用时无法连接特定BLE外设求助

结合你遇到的旧Android应用BLE连接问题，还有RxAndroidBle的测试结果，我来帮你拆解核心原因和给出可行的修复方案：

核心原因分析 #

首先得明确：API21（Android 5.0）的BLE栈存在不少未完善的兼容性坑，你的问题刚好踩中了两个关键点：

• 扫描与连接的冲突：你猜测的“仅发现设备就建立半损坏连接”是完全成立的！很多小众或兼容性弱的BLE外设，在持续被扫描时会进入一种“预应答”状态，此时主动调用connectGatt(false)（即时连接）会被设备或Android栈误判为已连接，直接抛出“already connected”错误。而autoConnect(true)是系统层面的后台连接机制，它会等待外设释放连接资源后再发起请求，所以能绕过这个异常状态。
• 旧Gatt实例未清理+扫描未及时停止：旧应用不管autoConnect设置如何都失败，大概率是双重问题叠加：一是发现设备后没有立即终止扫描，二是之前的连接请求留下了无效的BluetoothGatt实例，导致BLE栈的连接状态彻底混乱。

具体修复步骤 #

针对你的旧应用，建议按以下顺序调整：

1. 发现目标设备后立即停止扫描 #

不要依赖任何“自动停止扫描”的逻辑，在扫描回调中匹配到目标设备地址后，立刻调用停止扫描的API（API21对应BluetoothAdapter.stopLeScan()），并且确保所有注册的扫描回调都被移除。哪怕延迟几百毫秒，都可能让外设卡在异常状态。

示例代码：

// 扫描回调中匹配到目标设备后
@Override
public void onLeScan(BluetoothDevice device, int rssi, byte[] scanRecord) {
    if (TARGET_DEVICE_ADDRESS.equals(device.getAddress())) {
        // 立即停止扫描
        bluetoothAdapter.stopLeScan(this);
        // 延迟发起连接（关键缓冲步骤）
        new Handler(Looper.getMainLooper()).postDelayed(() -> connectToDevice(device), 300);
    }
}

2. 彻底清理旧的BluetoothGatt实例 #

API21的BluetoothGatt经常会出现“假死”——设备已经断开，但实例仍然持有连接引用，导致新连接请求被误判。在发起新连接前，务必遍历所有已创建的Gatt实例执行清理：

// 全局维护的Gatt实例列表
private List<BluetoothGatt> gattInstanceList = new ArrayList<>();

private void cleanUpStaleGattInstances() {
    for (BluetoothGatt gatt : gattInstanceList) {
        gatt.disconnect();
        gatt.close();
    }
    gattInstanceList.clear();
}

// 发起连接前先执行清理
cleanUpStaleGattInstances();
BluetoothGatt newGatt = device.connectGatt(context, isAutoConnect, gattCallback);
gattInstanceList.add(newGatt);

3. 延迟发起连接 #

不要在扫描回调中直接调用connectGatt()，给外设300-500ms的缓冲时间，让它从扫描响应状态恢复到可正常连接的状态。这一步是解决大部分外设兼容性问题的关键。

4. 优先使用autoConnect模式（业务允许的话） #

如果你的应用不需要极致的即时连接速度，建议强制开启autoConnect=true。API21的系统连接机制会自动处理重试和状态冲突，比主动连接稳定得多。如果必须用即时连接，可以先通过autoConnect=true建立连接，再执行后续的Gatt操作。

额外排查点 #

• 检查旧应用是否存在多线程重复发起连接的情况，比如多个模块同时调用connectGatt()，导致BLE栈收到重复请求，触发“already connected”错误。
• 参考Nordic nRF应用的逻辑：nRF确实做了大量兼容性优化，比如扫描时过滤无效广告包、连接前重置栈状态、多轮重试机制等，你可以对照这些逻辑优化旧应用的连接流程。

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