Android BLE心率应用扫描与连接故障排查求助

针对你遇到的「扫描正常但BLE心率设备连接失败」问题，结合Android BLE的特性和常见坑，整理以下排查方向：

一、核心连接流程校验 #

• 必须直接使用扫描回调返回的BluetoothDevice对象发起连接，禁止手动拼接MAC地址创建设备实例——部分Android版本对MAC地址的格式校验或权限限制严格，手动创建的实例大概率无法连接。
• 确保BluetoothGattCallback的生命周期与宿主组件（Activity/Fragment）一致，避免回调实例被GC回收导致连接无响应；同时不要在回调的主线程方法中做耗时操作，比如同步读写特征值。

二、权限与系统适配细节 #

即使已声明权限，仍需核对以下适配点：

• Android 12+：除了BLUETOOTH_SCAN、BLUETOOTH_CONNECT，扫描时需添加android:usesPermissionFlags="neverForLocation"（无需位置权限场景），否则可能因位置权限缺失间接影响连接；后台连接需在清单中声明android:foregroundServiceType="connectedDevice"。
• Android 10及以下：必须授予ACCESS_FINE_LOCATION动态权限，即使应用不需要位置信息，系统也会以此作为BLE扫描/连接的前提。
• 检查权限是否真正授予：在代码中调用checkSelfPermission()确认BLUETOOTH_CONNECT等权限的授权状态，避免仅在清单声明但未动态申请。

三、代码层面的常见错误排查 #

扫描阶段的遗留问题 #

对比前后版本的扫描代码，确认：

• 扫描过滤器是否正确：心率服务的标准UUID是0000180d-0000-1000-8000-00805f9b34fb，如果扫描时添加了该过滤器，需确认目标设备确实广播了此服务UUID，避免过滤掉有效设备。
• 扫描停止时机：连接前必须调用bluetoothLeScanner.stopScan(callback)或bluetoothAdapter.stopLeScan()终止扫描，扫描和连接同时进行会占用蓝牙资源导致连接失败。

连接阶段的关键参数与逻辑 #

• autoConnect参数：首次连接建议设置为false，该模式会快速发起连接请求；autoConnect=true适合后台重连场景，但首次连接可能因等待超时失败。
• BluetoothGatt实例管理：每次连接前，若存在之前的BluetoothGatt实例，必须先调用close()释放资源，多个实例同时存在会导致蓝牙栈混乱。
• 解析连接回调的错误码：在onConnectionStateChange中打印status和newState，根据错误码定位问题：
  • status=0：连接正常，后续需发现服务、订阅心率特征值；
  • status=5：认证失败，目标设备需要配对，需在代码中监听ACTION_PAIRING_REQUEST广播并处理配对逻辑；
  • status=133：连接超时，可能是设备距离过远、设备已离线，或扫描到的设备信息已过期。

四、设备与系统缓存问题 #

• 清除目标设备的蓝牙配对记录：系统可能缓存了之前的无效配对信息，在系统蓝牙设置中删除设备后重新扫描连接。
• 测试设备配对流程：部分心率设备需要手动配对，打开系统蓝牙设置，尝试手动配对目标设备，确认配对成功后再用应用连接。

五、日志调试建议 #

在关键节点添加日志，精准定位问题：

// 发起连接前打印设备信息
Log.d("BLE", "Connecting to: " + device.getName() + " | MAC: " + device.getAddress());

// 连接状态回调日志
@Override
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
    super.onConnectionStateChange(gatt, status, newState);
    String state = newState == BluetoothProfile.STATE_CONNECTED ? "CONNECTED" : 
                   newState == BluetoothProfile.STATE_DISCONNECTED ? "DISCONNECTED" : "UNKNOWN";
    Log.d("BLE", "Connection Status: " + status + " | New State: " + state);
}

通过status值可以快速定位具体故障类型，比如status=133优先排查设备可达性，status=5优先处理配对逻辑。

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