Flutter多权限申请校验异常：权限被拒仍跳转页面

现有代码存在4个核心逻辑错误，导致交互不符合预期：

• 跳转判断条件status.toString().contains('${status.toString()}')为恒真表达式，无论权限申请结果如何都会满足，必然执行页面跳转
• 权限拒绝判断逻辑错误：status是存储多权限结果的Map<Permission, PermissionStatus>类型对象，直接和单个枚举值PermissionStatus.denied对比永远无法得到正确结果
• 未实现拒绝次数持久化计数逻辑，无法满足「连续2次拒绝后第三次触发申请直接打开设置页」的要求
• 未做「三项权限全部授权」的前置校验，只要走到跳转分支就会无条件进入目标页

前置准备 #

首先在pubspec.yaml中引入所需依赖：

dependencies:
  flutter:
    sdk: flutter
  permission_handler: ^11.0.0 # 权限处理库，可替换为最新版本
  shared_preferences: ^2.2.0 # 本地键值对存储，可替换为最新版本

按照permission_handler库的官方文档，在对应平台配置文件中声明需要的权限：Android端修改AndroidManifest.xml，iOS端修改Info.plist添加权限描述文案，否则权限申请会直接失败。

注意：Android 13及以上版本不再使用Permission.storage，需要根据实际存储访问场景替换为Permission.photos/Permission.videos/Permission.audio等细分媒体权限。

完整实现代码 #

先定义常量用于本地存储计数：

// 权限拒绝次数本地存储key
const String _kPermissionDenyCountKey = 'permission_deny_count';
// 连续拒绝阈值：连续拒绝2次后，第三次触发申请直接打开设置页
const int _kMaxAllowDenyTimes = 2;

重写权限申请与跳转逻辑：

void goToHome(BuildContext context) async {
  final SharedPreferences prefs = await SharedPreferences.getInstance();
  int denyCount = prefs.getInt(_kPermissionDenyCountKey) ?? 0;

  // 达到拒绝次数阈值，直接打开应用设置
  if (denyCount >= _kMaxAllowDenyTimes) {
    if (context.mounted) {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('已连续拒绝权限，请在设置页手动开启所需权限')),
      );
    }
    await openAppSettings();
    // 从设置页返回后重置计数，重新校验权限状态
    denyCount = 0;
    await prefs.setInt(_kPermissionDenyCountKey, denyCount);
  }

  // 批量申请三项权限
  final Map<Permission, PermissionStatus> statusMap = await [
    Permission.camera,
    Permission.storage,
    Permission.location,
  ].request();

  // 遍历校验所有权限状态
  bool allPermissionGranted = true;
  bool hasPermanentDenied = false;
  statusMap.forEach((permission, status) {
    if (status != PermissionStatus.granted) {
      allPermissionGranted = false;
      if (status == PermissionStatus.permanentlyDenied || 
          status == PermissionStatus.restricted) {
        hasPermanentDenied = true;
      }
    }
  });

  // 所有权限均授权，跳转目标页
  if (allPermissionGranted) {
    // 授权成功后重置拒绝计数
    await prefs.setInt(_kPermissionDenyCountKey, 0);
    await prefs.setInt('isBoarding', 0);
    if (context.mounted) {
      Navigator.of(context).pushReplacement(
        MaterialPageRoute(builder: (_) => const HomeScreen()),
      );
    }
    return;
  }

  // 存在永久拒绝/受限权限，直接打开设置页
  if (hasPermanentDenied) {
    if (context.mounted) {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('存在权限被永久拒绝，请在设置页手动开启')),
      );
    }
    await openAppSettings();
    // 从设置页返回后重新校验权限
    if (context.mounted) {
      goToHome(context);
    }
    return;
  }

  // 普通拒绝场景：拒绝次数+1，提示后重新发起申请
  denyCount += 1;
  await prefs.setInt(_kPermissionDenyCountKey, denyCount);
  if (context.mounted) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text('请授权所有必要权限，剩余申请次数：${_kMaxAllowDenyTimes - denyCount + 1}')),
    );
    goToHome(context);
  }
}

逻辑说明 #

• 每次进入方法先读取本地存储的历史拒绝次数，达到阈值直接跳转应用设置，避免重复弹窗骚扰用户
• 权限申请完成后遍历所有返回结果，仅当三项权限全部为granted状态时才执行页面跳转，跳转前重置拒绝计数
• 检测到永久拒绝/受限权限时，直接弹出提示并打开设置页，用户从设置返回后自动重新校验权限状态
• 普通拒绝场景下累加拒绝次数，给出明确提示后递归触发申请逻辑，直到授权成功或达到拒绝阈值
• 所有涉及上下文操作（弹窗、路由跳转）前都校验context.mounted状态，避免异步执行时组件销毁导致的运行时报错

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