Flutter从v3.19.x升级至v3.22.x后Android定位访问崩溃求助

核心原因推测 #

Flutter 3.22.x升级后，定位相关的引擎逻辑或使用的定位插件（如geolocator）在覆盖安装场景下，存在权限检测/请求逻辑的变化：

• 旧版本仅请求ACCESS_COARSE_LOCATION，覆盖安装后系统权限缓存未更新，导致新版本误判权限状态，尝试访问需要ACCESS_FINE_LOCATION的API
• ACCESS_COARSE_LOCATION和ACCESS_FINE_LOCATION同属定位权限组，覆盖安装时系统可能保留旧权限组状态，但新版本的权限请求逻辑未适配这种场景

可落地的解决方案 #

1. 临时兼容：双权限声明+显式指定低精度请求

在AndroidManifest.xml中同时声明两个权限：

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

同时在代码中显式指定使用低精度定位，避免插件自动请求高精度权限：

// 以geolocator为例
import 'package:geolocator/geolocator.dart';

Future<void> getCoarseLocation() async {
  // 明确请求低精度权限
  LocationPermission permission = await Geolocator.requestPermission(
    locationPermissionLevel: LocationPermissionLevel.coarse,
  );
  
  if (permission == LocationPermission.denied) {
    // 处理权限拒绝逻辑
    return;
  }
  
  // 使用低精度设置获取定位
  Position position = await Geolocator.getCurrentPosition(
    locationSettings: LocationSettings(accuracy: LocationAccuracy.low),
  );
}

这个方案能快速解决覆盖安装崩溃问题，无需用户卸载重装。

2. 强制刷新权限状态

在应用启动时主动检查并刷新权限状态，清除系统缓存的旧权限信息：

import 'package:permission_handler/permission_handler.dart';

void initPermissions() async {
  // 主动检查粗定位权限状态
  PermissionStatus status = await Permission.locationCoarse.status;
  if (status == PermissionStatus.granted) {
    // 尝试重新请求一次（触发系统权限状态同步）
    await Permission.locationCoarse.request();
  }
}

调用时机放在main()函数初始化阶段，确保应用启动时就完成权限状态同步。

3. 检测覆盖安装并引导权限重置

通过版本号对比判断是否为覆盖安装，若为覆盖安装则引导用户进入权限设置页重新确认：

import 'package:package_info_plus/package_info_plus.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:permission_handler/permission_handler.dart';

Future<void> checkUpgradeScenario() async {
  PackageInfo packageInfo = await PackageInfo.fromPackageInfo();
  String currentVersion = packageInfo.version;
  
  SharedPreferences prefs = await SharedPreferences.getInstance();
  String? lastVersion = prefs.getString('last_app_version');
  
  if (lastVersion != null && lastVersion != currentVersion) {
    // 覆盖安装场景，引导用户进入权限设置页
    await openAppSettings();
    // 保存当前版本号
    await prefs.setString('last_app_version', currentVersion);
  } else {
    await prefs.setString('last_app_version', currentVersion);
  }
}

这个方案能强制用户同步权限状态，适合用户量较大的场景，避免静默崩溃。

4. 回退定位插件版本

如果是定位插件与Flutter 3.22.x不兼容导致的问题，可尝试回退到旧版本插件（比如在3.19.x下稳定运行的版本），例如在pubspec.yaml中指定：

dependencies:
  geolocator: ^10.1.0 # 替换为你之前稳定使用的版本

先保证升级流程稳定，后续再逐步适配新版本插件。

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