Android 14设备无法通过BLE接收数据问题排查求助

核心原因分析 #

Android 14对隐式广播接收做了更严格的限制，Nordic BLE库的ACTION_DATA_AVAILABLE这类数据更新广播属于自定义隐式广播范畴。在Android 12/13中，这类广播还能通过传统方式接收，但Android 14进一步收紧规则，仅允许少数系统级隐式广播被静态接收，自定义隐式广播无法再通过静态注册的BroadcastReceiver获取；而连接/断开这类状态广播属于系统允许的例外场景，所以仍能正常接收。

另外，Nordic BLE库v2.9.0发布于Android 14正式版之前，未针对该版本的广播限制做适配。

具体解决步骤 #

1. 改用动态注册BroadcastReceiver #

在组件生命周期内动态注册接收器，确保仅在需要时接收广播，避免静态注册的限制：

// 在Composable中通过LaunchedEffect注册
LaunchedEffect(Unit) {
    val filter = IntentFilter().apply {
        addAction(bluetoothManager.actionConnected)
        addAction(bluetoothManager.actionDisconnected)
        addAction(bluetoothManager.actionDataAvailable)
        addAction(bluetoothManager.actionInfoAvailable)
        addAction(bluetoothManager.actionError)
    }
    context.registerReceiver(dataReceiver, filter)
    
    // 组件销毁时注销接收器
    awaitDispose {
        context.unregisterReceiver(dataReceiver)
    }
}

2. 确认BLE权限配置 #

Android 14对BLE权限要求更细化，确保Manifest中已正确声明权限：

<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30" />

同时需在运行时为Android 12+设备请求BLUETOOTH_SCAN和BLUETOOTH_CONNECT权限。

3. 升级Nordic BLE库版本 #

检查官方是否发布适配Android 14的新版本（如v2.10.0及以后），新版本通常会针对系统规则调整，改用LocalBroadcastManager或LiveData/Flow等更兼容的方式传递数据。

4. 替代方案：使用库原生回调接口 #

直接使用Nordic BLE库提供的回调方法，绕过广播机制，避免系统限制：

bluetoothManager.setDataCallback(object : BluetoothManager.DataCallback {
    override fun onDataReceived(device: BluetoothDevice, data: ByteArray) {
        // 处理接收到的设备数据
    }

    override fun onInfoReceived(device: BluetoothDevice, info: String) {
        // 处理信息类数据
    }
})

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