蓝牙LeScan无法在目标设备运行，已配置权限求解决方案

嘿，我来帮你排查一下蓝牙LeScan跑不起来的问题！从你给出的代码片段和描述来看，咱们可以从这几个常见的坑入手逐一排查：

你提到已经在Manifest里加了蓝牙权限，但不同Android版本对BLE扫描的权限要求不一样，很可能是权限漏配了：

• 基础蓝牙权限：BLUETOOTH、BLUETOOTH_ADMIN这俩是必须的，但Android 12及以上还要加细分的BLUETOOTH_SCAN和BLUETOOTH_CONNECT权限；
• 重点！Android 6.0（API 23）及以上，BLE扫描必须申请位置权限（ACCESS_FINE_LOCATION或ACCESS_COARSE_LOCATION），因为系统把BLE扫描和位置服务绑定了；
• 还要在Manifest里声明应用支持BLE功能。

给你一份完整的权限配置参考：

<!-- 基础蓝牙权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<!-- Android 12+ 新增细分权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<!-- 位置权限（API23+必须） -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- 声明应用支持BLE -->
<uses-feature android:name="android.hardware.bluetooth_le" android:required="true" />

另外，位置权限属于危险权限，不能只靠Manifest配置，必须在代码里动态申请，比如在扫描前加这段逻辑：

private static final int REQUEST_LOCATION_PERM = 2;

// 检查并申请位置权限
private void checkLocationPermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) 
            != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, 
                new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, 
                REQUEST_LOCATION_PERM);
    } else {
        // 权限已获取，可以开始扫描
        startScan();
    }
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_LOCATION_PERM) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            startScan();
        } else {
            Toast.makeText(this, "需要位置权限才能扫描BLE设备", Toast.LENGTH_SHORT).show();
        }
    }
}

你的代码里定义了REQUEST_ENABLE_BT，但要确保你处理了蓝牙开启的请求结果，只有蓝牙成功开启后，扫描才能正常工作。比如用旧API的onActivityResult处理：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_ENABLE_BT) {
        if (resultCode == RESULT_OK) {
            // 蓝牙开启成功，先检查位置权限再扫描
            checkLocationPermission();
        } else {
            Toast.makeText(this, "必须开启蓝牙才能使用扫描功能", Toast.LENGTH_SHORT).show();
        }
    }
}

还要注意初始化蓝牙适配器时要判空，避免设备不支持蓝牙的情况：

bluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE);
mBluetoothAdapter = bluetoothManager.getAdapter();
if (mBluetoothAdapter == null) {
    Toast.makeText(this, "当前设备不支持蓝牙功能", Toast.LENGTH_SHORT).show();
    finish();
}

从Android 5.0（API 21）开始，LeScan就被标记为弃用了，高版本系统可能会限制这个旧API的使用，换成BluetoothLeScanner会更稳定：
首先获取扫描实例：

BluetoothLeScanner bleScanner = mBluetoothAdapter.getBluetoothLeScanner();

然后定义扫描回调，处理扫描结果：

private ScanCallback bleScanCallback = new ScanCallback() {
    @Override
    public void onScanResult(int callbackType, ScanResult result) {
        super.onScanResult(callbackType, result);
        BluetoothDevice device = result.getDevice();
        // 这里处理扫描到的设备，比如打印设备名称和地址
        Log.d("BLE_SCAN", "找到设备：" + (device.getName() != null ? device.getName() : "未知设备") 
                + "，MAC地址：" + device.getAddress());
    }

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

最后启动扫描，并用Handler控制扫描时长（比如你设置的10秒）：

private void startScan() {
    if (mBluetoothAdapter == null || !mBluetoothAdapter.isEnabled()) {
        Toast.makeText(this, "蓝牙未开启", Toast.LENGTH_SHORT).show();
        return;
    }
    BluetoothLeScanner bleScanner = mBluetoothAdapter.getBluetoothLeScanner();
    if (bleScanner == null) {
        Toast.makeText(this, "设备不支持BLE扫描", Toast.LENGTH_SHORT).show();
        return;
    }

    // 设置扫描参数，低延迟模式适合快速扫描
    ScanSettings scanSettings = new ScanSettings.Builder()
            .setScanMode(ScanSettings.SCAN_MODE_LOW_LATENCY)
            .build();

    // 启动扫描，filters传null表示扫描所有BLE设备
    bleScanner.startScan(null, scanSettings, bleScanCallback);

    // 10秒后停止扫描
    mHandler.postDelayed(() -> bleScanner.stopScan(bleScanCallback), SCAN_PERIOD);
}

• 检查设备是否真的支持BLE：可以用getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE)提前判断；
• 不要在主线程做耗时操作，但扫描回调本身是异步的，要是在回调里更新UI，记得切回主线程；
• 如果已经连接了其他BLE设备，可能会影响扫描，建议先断开连接再尝试扫描。

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