BLE设备连接异常及APP获取BLE设备电池信息时ScanCallback无返回问题

我来帮你梳理下这两个BLE相关的问题，先从扫描无结果这个核心痛点入手——毕竟扫描是建立连接的第一步：

一、ScanCallback扫描无返回结果的排查与解决 #

扫描没结果大概率是权限、扫描配置或设备状态出了问题，按以下步骤逐一排查：

1. 权限检查（重中之重） #

Android不同版本对BLE权限的要求差异很大，少一个权限都可能直接导致扫描失败：

• 先在AndroidManifest.xml中添加静态权限：

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- Android 12+ 新增的BLE专属权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-feature android:name="android.hardware.bluetooth_le" android:required="true" />

• 再做动态权限申请（Android 6.0+必须执行）：

private static final int REQUEST_BLE_PERMISSIONS = 1001;
private final String[] requiredPermissions = {
    Manifest.permission.ACCESS_FINE_LOCATION,
    Manifest.permission.BLUETOOTH_SCAN,
    Manifest.permission.BLUETOOTH_CONNECT
};

// 在Activity/Fragment中检查并申请权限
if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED ||
    ContextCompat.checkSelfPermission(this, Manifest.permission.BLUETOOTH_SCAN) != PackageManager.PERMISSION_GRANTED ||
    ContextCompat.checkSelfPermission(this, Manifest.permission.BLUETOOTH_CONNECT) != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this, requiredPermissions, REQUEST_BLE_PERMISSIONS);
}

另外注意：部分Android设备必须开启位置服务才能扫描BLE设备，别漏了这一步！

2. 扫描配置优化 #

你的扫描代码可能存在配置疏漏：

• 不要注释super.onScanResult，虽然它本身不影响结果，但遵守框架规范能避免潜在的未知问题；
• 选择合适的扫描模式，比如SCAN_MODE_LOW_LATENCY适合主动扫描（功耗略高但扫描响应更快）；
• 避免设置过严的过滤条件，如果不需要筛选特定设备，直接传空的ScanFilter列表即可：

// 修正后的扫描启动代码
BluetoothLeScanner scanner = bluetoothAdapter.getBluetoothLeScanner();
ScanSettings scanSettings = new ScanSettings.Builder()
        .setScanMode(ScanSettings.SCAN_MODE_LOW_LATENCY) // 优先用低延迟模式
        .build();
List<ScanFilter> filters = new ArrayList<>(); // 无过滤条件，扫描所有BLE设备
scanner.startScan(filters, scanSettings, scanCallback);

3. 完善ScanCallback的错误反馈 #

一定要实现onScanFailed方法，它能帮你快速定位扫描失败的具体原因：

private ScanCallback scanCallback = new ScanCallback() {
    @Override
    public void onScanResult(int callbackType, ScanResult result) {
        super.onScanResult(callbackType, result);
        BluetoothDevice device = result.getDevice();
        Log.e("scanning result", "设备名: " + device.getName() + " | 地址: " + device.getAddress());
        bluetoothDevice = device; // 赋值给全局变量
    }

    @Override
    public void onScanFailed(int errorCode) {
        super.onScanFailed(errorCode);
        // 常见错误码：2=蓝牙未开启，3=权限不足，4=扫描功能不可用
        Log.e("扫描失败", "错误码: " + errorCode);
    }
};

4. 设备状态验证 #

• 确认两台设备的蓝牙都已正常开启；
• 用第三方工具（比如nRF Connect）测试：如果第三方工具也扫不到对方设备，那问题出在对方设备的BLE广播配置上——比如没有开启广播、广播的UUID不正确等。

二、移动设备间无法建立BLE连接的解决 #

扫描到设备后无法连接，通常是以下原因导致：

• 对方设备未开启GATT服务器：BLE连接需要一方作为GATT服务器广播服务UUID，另一方作为客户端发起连接；
• 连接参数错误：调用connectGatt时，autoConnect参数设为false适合主动连接（true更适合后台自动重连场景）：

BluetoothGatt gatt = bluetoothDevice.connectGatt(this, false, gattCallback);

• 权限不足：确保已申请BLUETOOTH_CONNECT权限；
• 连接范围问题：BLE有效连接范围一般在10米内，确保两台设备距离足够近。

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