第3章 蓝牙经典权限：BLUETOOTH与BLUETOOTH_ADMIN

蓝牙经典权限（BLUETOOTH 与 BLUETOOTH_ADMIN）是 Android 平台早在 API 级别 5（Android 2.0）引入的基础蓝牙操作权限。虽然 Android 12（API 31）之后新增了扫描/连接/广播细粒度权限，但旧版经典权限在 targetSdkVersion < 31 的应用中仍然广泛使用，且是许多遗留系统和车载应用的核心适配对象。

3.1 权限声明方式

在 AndroidManifest.xml 中使用 <uses-permission> 标签声明，两个权限通常成对出现。

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 允许应用连接到已配对的蓝牙设备 -->
    <uses-permission android:name="android.permission.BLUETOOTH" />

    <!-- 允许应用发现本地蓝牙设备或修改蓝牙设置 -->
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
</manifest>

3.2 作用域

两个权限各自控制蓝牙操作的不同环节，下表总结了每个权限覆盖的 API 范围：

3.3 特殊说明与限制

3.3.1 运行时权限的特殊表现

尽管权限保护级别标记为 Dangerous，但 Android 系统对这两个权限采用了特殊处理：

• 不弹运行时授权对话框：安装时自动授予，用户无法通过系统设置单独撤销。
• 不触发运行时请求流程：调用 ActivityCompat.requestPermissions() 不会弹出 UI。
• Android 12+ 行为变更：如果 targetSdkVersion ≥ 31，系统会忽略 BLUETOOTH/BLUETOOTH_ADMIN 的声明，必须改用新的 BLUETOOTH_SCAN/BLUETOOTH_CONNECT，否则操作直接返回失败。

3.3.2 权限与设备发现（Discovery）的关系

BLUETOOTH_ADMIN 权限仅允许发起 发现过程，但发现过程中的 广播接收（ACTION_FOUND）还需要 BLUETOOTH 权限才能获取设备信息。

// 错误示例：仅有 BLUETOOTH_ADMIN 时无法获取扫描结果
IntentFilter filter = new IntentFilter(BluetoothDevice.ACTION_FOUND);
registerReceiver(receiver, filter);
// 如果没有 BLUETOOTH 权限，receiver 不会接收任何广播

3.3.3 配对（Bonding）流程中的权限要求

配对过程中系统自动处理大部分 UI，但应用调用 createBond() 需要 BLUETOOTH_ADMIN 权限。配对完成后，getBondedDevices() 需要 BLUETOOTH 权限。

3.4 蓝牙经典权限声明与使用流程

下图展示了经典权限在应用启动、蓝牙操作和异常处理中的完整生命周期：

3.5 异常处理与调试

缺少 BLUETOOTH 或 BLUETOOTH_ADMIN 权限时，系统会抛出 SecurityException，典型日志如下：

java.lang.SecurityException: Need BLUETOOTH permission: Neither user 10123
nor current process has android.permission.BLUETOOTH.

调试步骤：

1. 通过 adb shell dumpsys package PACKAGE_NAME | grep permission 查看已授予权限列表。
2. 确认 BLUETOOTH 和 BLUETOOTH_ADMIN 是否已出现在 granted 列表中。
3. 若 targetSdkVersion ≥ 31，检查是否额外声明了 BLUETOOTH_SCAN 和 BLUETOOTH_CONNECT。
4. 调用 checkSelfPermission() 在运行时验证权限状态，即使不弹窗也可用于排查。

// 运行时检查经典权限（即使不弹窗）
int result = ContextCompat.checkSelfPermission(
    context,
    Manifest.permission.BLUETOOTH
);
if (result != PackageManager.PERMISSION_GRANTED) {
    // 正常不会进入此分支，但 Android 12+ 迁移时可能发生
    Log.w("BT_Permission", "BLUETOOTH 未授予，需检查 targetSdkVersion");
}

3.6 性能与稳定性优化