Android Oreo中BLE扫描回调（ScanCallback）无响应问题求助

我帮你梳理下常见的排查方向和解决方案，毕竟BLE扫描不触发回调这个问题我也碰到过好几次，大概率是权限、蓝牙状态或者代码配置的问题，咱们一步步来：

一、先把权限这块盯紧，这是最容易踩的坑 #

Android对BLE的权限限制一直很严格，不同版本要求还不一样：

• Android 11及以下：需要在清单文件里声明BLUETOOTH、BLUETOOTH_ADMIN，还有ACCESS_FINE_LOCATION（划重点！BLE扫描依赖位置权限，哪怕你不需要位置信息也得申请），而且这些都是危险权限，必须动态申请，不能只靠清单声明。
• Android 12及以上：新增了BLUETOOTH_SCAN和BLUETOOTH_CONNECT权限，同样要动态申请，同时如果你的App在后台扫描，还得确保位置权限已授予，或者在申请BLUETOOTH_SCAN时加上neverForLocation的权限标记（如果你不需要通过BLE获取位置）。

给你贴个权限申请的示例代码：

private static final int REQUEST_BLE_PERMISSIONS = 1001;

private String[] getRequiredPermissions() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        return new String[]{
            Manifest.permission.BLUETOOTH_SCAN,
            Manifest.permission.BLUETOOTH_CONNECT,
            Manifest.permission.ACCESS_FINE_LOCATION
        };
    } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        return new String[]{
            Manifest.permission.ACCESS_FINE_LOCATION,
            Manifest.permission.BLUETOOTH_ADMIN,
            Manifest.permission.BLUETOOTH
        };
    }
    return new String[]{};
}

// 在Activity里调用申请权限
private void requestBlePermissions() {
    String[] permissions = getRequiredPermissions();
    if (permissions.length > 0 && ContextCompat.checkSelfPermission(this, permissions[0]) != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, permissions, REQUEST_BLE_PERMISSIONS);
    }
}

二、确认蓝牙基础状态正常 #

别光顾着写代码，先确认设备本身的BLE功能没问题：

• 检查设备是否支持BLE：调用getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE)，返回false的话直接放弃，设备不支持。
• 确保蓝牙已经打开：可以用BluetoothAdapter.isEnabled()检查，如果没开，要么引导用户手动打开，要么发送ACTION_REQUEST_ENABLE的Intent请求开启。
• 拿到有效的BluetoothLeScanner实例：必须从已启用的BluetoothAdapter获取，比如bluetoothAdapter.getBluetoothLeScanner()，如果返回null，说明蓝牙服务没正常启动。

三、检查扫描代码的配置细节 #

很多时候权限和蓝牙都没问题，就是扫描的参数配置错了：

• ScanCallback的生命周期：如果你的回调是匿名内部类，要确保它的引用不会被GC回收，比如把它声明成Activity的成员变量，而不是在方法里临时创建。
• ScanSettings的扫描模式：前台扫描建议用SCAN_MODE_LOW_LATENCY（低延迟），后台扫描用SCAN_MODE_LOW_POWER，如果模式选不对，可能扫描频率太低或者根本不扫描。
• ScanFilter别太苛刻：如果你设置了过滤条件，比如指定了设备名称或UUID，而周围没有匹配的设备，回调自然不会触发。测试阶段可以先不传filter，用空列表试试能不能扫到设备。
• 别忘了处理onScanFailed：这个方法很重要！如果扫描失败，它会返回错误码，比如：
  • 错误码2：设备不支持BLE
  • 错误码3：权限不足
  • 错误码4：蓝牙适配器未启用
    把错误码打出来，能快速定位问题。

给你一个标准的扫描代码示例：

private BluetoothLeScanner bleScanner;
private ScanCallback scanCallback = new ScanCallback() {
    @Override
    public void onScanResult(int callbackType, ScanResult result) {
        super.onScanResult(callbackType, result);
        Log.d("BLE_SCAN", "发现设备: " + result.getDevice().getName() + " | " + result.getDevice().getAddress());
        // 这里处理扫描到的设备
    }

    @Override
    public void onScanFailed(int errorCode) {
        super.onScanFailed(errorCode);
        Log.e("BLE_SCAN", "扫描失败，错误码: " + errorCode);
        // 根据错误码排查问题
    }
};

// 初始化扫描器
private void initBleScanner() {
    BluetoothAdapter bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
    if (bluetoothAdapter != null && bluetoothAdapter.isEnabled()) {
        bleScanner = bluetoothAdapter.getBluetoothLeScanner();
    } else {
        Log.e("BLE_SCAN", "蓝牙未启用或不支持");
    }
}

// 开始扫描
public void startBleScan() {
    if (bleScanner == null) {
        Log.e("BLE_SCAN", "扫描器未初始化");
        return;
    }
    ScanSettings scanSettings = new ScanSettings.Builder()
            .setScanMode(ScanSettings.SCAN_MODE_LOW_LATENCY)
            .build();
    List<ScanFilter> scanFilters = new ArrayList<>(); // 空列表，不过滤
    bleScanner.startScan(scanFilters, scanSettings, scanCallback);
}

// 停止扫描（记得在合适的时机调用，比如页面销毁时）
public void stopBleScan() {
    if (bleScanner != null) {
        bleScanner.stopScan(scanCallback);
    }
}

四、其他容易忽略的细节 #

• 不要重复调用startScan：如果已经在扫描，再次调用可能会导致回调异常，建议每次扫描前先调用stopScan。
• 后台扫描限制：Android 8.0+对后台扫描的频率有严格限制，Android 12+甚至要求后台扫描必须申请对应的权限，所以如果你的App在后台运行，可能需要调整扫描策略。
• 查看Logcat日志：搜索BluetoothLeScanner或者ScanCallback相关的日志，有时候系统会输出权限拒绝、服务异常等信息，帮你找到问题根源。

你可以按照这个顺序一步步排查，先从权限和蓝牙状态入手，再检查代码配置，应该能解决问题。

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