使用permission_handler时蓝牙权限未询问即已授予的问题

问题详情 #

使用permission_handler包处理蓝牙权限时遇到异常：用户还未在权限弹窗中选择允许或拒绝，蓝牙权限就已被标记为授予状态。

权限请求代码片段 #

final status = await permissions.request();
final bluetoothPermissions = [
  Permission.bluetooth,
  Permission.bluetoothConnect,
  Permission.bluetoothScan,
];
for (var item in status.entries) {
  log(status.entries.toSet().toList().toString(), name: "ALL BL PERMISSIONS");
  if (bluetoothPermissions.contains(item.key)) {
    if (item.value.isGranted) {
      return true;
    }
  }
}

Android清单配置 #

<uses-feature
        android:name="android.hardware.bluetooth_le"
        android:required="true" />
     <!-- required for API 18 - 30 -->
    <uses-permission
            android:name="android.permission.BLUETOOTH"/>
    <uses-permission
            android:name="android.permission.BLUETOOTH_ADMIN"/>
 <!-- API 31+ -->
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
    <uses-permission
            android:name="android.permission.BLUETOOTH_SCAN"
            android:usesPermissionFlags="neverForLocation" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />

额外信息 #

• 测试设备：华为荣耀10
• 系统版本：HarmonyOS 3.0
• 日志显示：BLUETOOTH、BLUETOOTH_CONNECT、BLUETOOTH_SCAN权限均被标记为granted，但用户未进行任何授权操作。

问题原因 #

1. HarmonyOS权限兼容特性：华为荣耀10升级到HarmonyOS 3.0后，Android API 30及以下的BLUETOOTH、BLUETOOTH_ADMIN权限会被系统自动授予（这类权限在旧Android版本中属于正常权限，无需用户交互）。permission_handler检测到这些权限已授予后，可能错误映射新权限（BLUETOOTH_CONNECT、BLUETOOTH_SCAN）的状态。
2. 代码逻辑误判：当前代码只要检测到任意一个蓝牙相关权限（包括无需授权的旧权限）已授予就返回true，跳过了对需要用户授权的新权限的验证。
3. permission_handler版本适配问题：旧版本的包对HarmonyOS的权限检测存在兼容漏洞，无法准确区分新旧蓝牙权限的授权状态。

解决方案 #

1. 修正权限检测逻辑 #

只针对需要用户授权的API 31+蓝牙权限验证，忽略无需交互的旧版权限：

final status = await permissions.request();
// 仅检测需要用户手动授权的新蓝牙权限
final requiredPermissions = [
  Permission.bluetoothConnect,
  Permission.bluetoothScan,
];

// 确保所有必要权限都已授予
bool allGranted = true;
for (var permission in requiredPermissions) {
  final permStatus = status[permission];
  if (permStatus == null || !permStatus.isGranted) {
    allGranted = false;
    break;
  }
}

// 打印精准的权限状态日志
log("蓝牙权限状态: ${requiredPermissions.map((p) => "$p: ${status[p]}").join(", ")}", name: "BL PERMISSIONS");
return allGranted;

2. 升级permission_handler到最新稳定版 #

前往pub.dev更新包到最新版本，确保其已适配HarmonyOS的权限检测规则，避免旧版本的兼容问题。

3. 精简Android清单权限 #

如果应用主要针对API 31+开发，可移除旧版的BLUETOOTH、BLUETOOTH_ADMIN权限（若无需兼容更低版本）；若需要兼容，保留但明确知晓这些权限无需用户授权，不纳入验证逻辑。

4. 手动验证权限状态 #

在权限请求前后，单独打印每个目标权限的状态，确认是否真的完成用户授权，避免依赖系统自动授予的旧权限状态误判。

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