Android隐式广播android.bluetooth.device.action.ACL

Android隐式广播android.bluetooth.device.action.ACL_CONNECTED失效问题

阿华AIGC实验室

2026-5-27

排查蓝牙ACL广播接收器未触发的问题

我之前也碰到过类似的蓝牙广播接收器不工作的情况，结合你的配置和问题，咱们从这几个方向逐一排查：

1. 修正Receiver的`permission`属性配置

你在Manifest里给receiver设置的android:permission属性存在两个问题：

这个属性的作用是限制只有持有指定权限的应用才能向该接收器发送广播，但系统发送的蓝牙ACL广播并不需要持有BLUETOOTH或BLUETOOTH_ADMIN权限，设置这个反而会导致系统无法触发你的接收器。
该属性仅支持指定单个权限，你写的逗号分隔格式是无效的。

建议直接移除这个android:permission属性，修改后的Manifest配置如下：

<receiver android:name=".BluetoothConnectionReceiver_" 
          android:enabled="true" 
          android:exported="true">
    <intent-filter>
        <action android:name="android.bluetooth.device.action.ACL_CONNECTED" />
        <action android:name="android.bluetooth.device.action.ACL_DISCONNECTED" />
    </intent-filter>
</receiver>

2. 确认蓝牙权限是否正确申请

不同Android版本对蓝牙权限的要求差异很大，务必确保你的应用已获取必要权限：

Android 11及以下：需要在Manifest中声明BLUETOOTH、BLUETOOTH_ADMIN；若需要扫描蓝牙设备，还得声明ACCESS_FINE_LOCATION并完成动态申请。
Android 12及以上：需要声明BLUETOOTH_CONNECT、BLUETOOTH_SCAN（扫描场景需要），且这些权限都必须动态申请。

3. 验证接收器类的正确性

检查BluetoothConnectionReceiver_类是否存在，类名是否和Manifest中的完全一致（包括下划线、大小写），并且该类正确继承了BroadcastReceiver并重写onReceive方法，示例代码如下：

public class BluetoothConnectionReceiver_ extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        if (BluetoothDevice.ACTION_ACL_CONNECTED.equals(action)) {
            Log.d("BluetoothReceiver", "设备已连接");
            // 处理连接逻辑
        } else if (BluetoothDevice.ACTION_ACL_DISCONNECTED.equals(action)) {
            Log.d("BluetoothReceiver", "设备已断开");
            // 处理断开逻辑
        }
    }
}

4. 测试场景与动态注册验证

确保测试设备确实执行了蓝牙连接/断开动作（比如连接蓝牙耳机后再断开），避免因测试场景无效导致的误判。
可以先尝试动态注册接收器，如果动态注册能接收到广播，说明静态Manifest配置仍有问题；如果动态也不行，大概率是权限或系统定制ROM的限制问题。

动态注册示例代码：

BluetoothConnectionReceiver_ receiver = new BluetoothConnectionReceiver_();
IntentFilter filter = new IntentFilter();
filter.addAction(BluetoothDevice.ACTION_ACL_CONNECTED);
filter.addAction(BluetoothDevice.ACTION_ACL_DISCONNECTED);
registerReceiver(receiver, filter);