Flutter安卓生产版无位置权限请求弹窗，自动标记为永久拒绝

问题描述 #

开发阶段Flutter应用位置权限请求正常，但Google Play发布版本调用权限请求时，无权限弹窗直接返回permanentlyDenied，应用设置中显示位置权限未被允许。本地执行flutter run --release测试时，出现MissingPluginException，提示找不到flutter.baseflow.com/permissions/methods通道的requestPermissions方法实现。

已尝试操作：

• 删除应用并执行flutter clean
• 检查AndroidManifest配置
• 将权限请求从Permission.location改为Permission.locationWhenInUse
• 确认AppBundle为release模式
• 测试相机权限正常
• 多台不同安卓版本设备验证

解决方案 #

1. 修复ProGuard/R8混淆导致的插件方法丢失 #

生产版release构建默认启用R8混淆，可能会混淆permission_handler插件的原生方法。在android/app/proguard-rules.pro中添加以下规则：

# Permission Handler 插件混淆豁免
-keep class com.baseflow.permissionhandler.** { *; }

添加后重新构建App Bundle。

2. 检查App Bundle的按需加载配置 #

Google Play App Bundle的拆分机制可能导致permission_handler的原生代码未正确打包到目标设备APK中。在android/app/build.gradle的android块下调整配置：

bundle {
    language {
        enableSplit = false
    }
    density {
        enableSplit = true
    }
    abi {
        enableSplit = true
    }
}

可暂时禁用ABI拆分测试是否为该问题导致：

bundle {
    abi {
        enableSplit = false
    }
}

3. 确保AndroidManifest权限注册完整 #

除基础权限外，需适配Android版本差异并添加权限说明：

<!-- Android 12及以下 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

<!-- Android 13+ -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 若需后台定位需添加 -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

同时在res/values/strings.xml中配置权限请求说明字符串：

<string name="permission_location_rationale">需要获取您的位置信息以提供相关服务</string>

4. 优化权限请求逻辑与错误捕获 #

当前代码未覆盖所有权限状态，且链式调用易掩盖异常。修改代码如下：

void _getUserLocation() async {
  final locationCubit = context.read<UserLocationCubit>();
  if (locationCubit.state != null) return;

  try {
    // 先检查当前权限状态
    PermissionStatus status = await Permission.locationWhenInUse.status;
    if (status == PermissionStatus.permanentlyDenied) {
      setState(() => locationDenied = true);
      // 引导用户跳转到应用设置
      await openAppSettings();
      return;
    }

    // 请求权限
    status = await Permission.locationWhenInUse.request();
    if (status.isGranted || status.isLimited) {
      setState(() => locationDenied = false);
      Position position = await Geolocator.getCurrentPosition(
        locationSettings: const LocationSettings(accuracy: LocationAccuracy.high),
      );
      LatLng newPosition = LatLng(position.latitude, position.longitude);
      locationCubit.set(location: newPosition);
      setState(() => userLocation = newPosition);
    } else {
      setState(() => locationDenied = true);
    }
  } catch (e) {
    debugPrint('权限请求错误: $e');
    setState(() => locationDenied = true);
  }
}

5. 重新构建并验证release包 #

执行以下步骤确保构建环境干净：

flutter clean
flutter pub get
flutter build appbundle --release

使用Google Play内部测试轨道上传测试，确认问题解决后再发布正式版本。

内容的提问来源于stack exchange，提问作者Pablo González Sánchez