Android Studio中蓝牙启用后扫描BLE设备崩溃问题求助

嘿，这个问题我帮不少刚接触BLE开发的小伙伴排查过，咱们先把核心问题理清楚：你目前的逻辑只在App启动时做了一次蓝牙状态检查，但当用户在App启动后才开启蓝牙时，你的扫描代码可能在蓝牙还没完全就绪、或者相关资源没初始化的情况下就被调用了，这才导致崩溃。下面是具体的解决思路和步骤：

1. 全程监听蓝牙状态变化，不要只检查一次 #

不管是Android还是iOS，都有专门的蓝牙状态变更通知机制：

• Android：注册BluetoothAdapter.ACTION_STATE_CHANGED广播，当蓝牙状态变为STATE_ON时，再触发扫描逻辑
• iOS：通过CBCentralManagerDelegate的centralManagerDidUpdateState(_:)方法，监听状态变为.poweredOn后再初始化扫描

这样就能确保你只在蓝牙真正可用的时候执行扫描，而不是依赖启动时的一次检查。

2. 等待蓝牙完全就绪后再启动扫描 #

很多新手会犯的错是：调用请求开启蓝牙的API后，立刻执行扫描代码。但蓝牙从关闭到开启需要一小段时间，这时候调用扫描API会触发IllegalStateException（Android）或者状态错误（iOS）。

正确的流程应该是：

• 检测到蓝牙未开启，弹出请求开启的提示
• 收到蓝牙状态变为开启的通知后，再初始化BLE扫描器、设置回调，最后启动扫描

3. 惰性加载BLE扫描相关对象 #

不要在App启动时就初始化扫描器、回调这些对象，而是在蓝牙确认开启后再创建实例。比如在Android中，不要在onCreate里就初始化BluetoothLeScanner，而是在收到蓝牙开启的广播后再获取实例：

// 收到蓝牙开启广播后执行
val bluetoothAdapter = BluetoothAdapter.getDefaultAdapter()
if (bluetoothAdapter?.state == BluetoothAdapter.STATE_ON) {
    val scanner = bluetoothAdapter.bluetoothLeScanner
    scanner?.startScan(scanCallback)
}

4. 增加异常捕获与错误提示 #

在扫描方法里加上异常捕获，避免崩溃同时给用户友好提示：

try {
    bluetoothLeScanner.startScan(scanCallback)
} catch (e: IllegalStateException) {
    Log.e("BLEDebug", "扫描失败：蓝牙未就绪", e)
    Toast.makeText(context, "蓝牙正在开启，请稍后再试", Toast.LENGTH_SHORT).show()
}

5. 校验权限（针对Android 12+） #

Android 12及以上需要单独申请BLUETOOTH_SCAN权限，并且在扫描前要确保权限已授予。可以在触发扫描前先检查权限：

if (ContextCompat.checkSelfPermission(context, Manifest.permission.BLUETOOTH_SCAN)
        != PackageManager.PERMISSION_GRANTED) {
    // 请求权限
    ActivityCompat.requestPermissions(activity, arrayOf(Manifest.permission.BLUETOOTH_SCAN), REQUEST_SCAN_PERMISSION)
    return
}
// 权限已授予，执行扫描

总结一下，核心就是让扫描逻辑完全依赖蓝牙状态的变更通知，而不是启动时的单次检查，同时做好资源初始化时机的控制和异常处理，就能解决这个崩溃问题啦。

内容的提问来源于stack exchange，提问作者flying-egg