Flutter Web应用：iOS浏览器授权后仍无法获取用户位置

问题背景 #

开发Flutter Web应用时，在iOS设备的Safari和Chrome浏览器中遇到以下问题：用户首次在权限弹窗选择「允许」后，应用仍无法获取位置；但手动进入Safari设置将位置权限从「询问」改为「允许」后，应用可正常获取位置。该问题仅出现在iOS浏览器环境中。

根本原因 #

1. iOS WebKit权限异步同步问题：iOS的Safari和Chrome（基于WebKit内核）中，权限授权的状态更新是异步的，Flutter的geolocator包在Web端可能在权限状态完全同步到WebKit进程前就发起位置请求，导致请求失败。
2. Chrome权限依赖Safari设置：Chrome for iOS的位置权限实际复用Safari的权限配置，首次授权后系统可能未及时将权限状态同步到Chrome的Web进程。

修复方案 #

1. 严格控制权限请求与位置获取的时序 #

必须等待权限状态明确变为PermissionStatus.granted后，再发起位置获取请求，避免异步状态未同步导致的失败。示例代码：

import 'package:geolocator/geolocator.dart';

Future<Position?> fetchUserLocation() async {
  // 先请求权限
  LocationPermission permission = await Geolocator.requestPermission();
  
  // 等待权限状态确认，处理异步同步延迟
  int retryCount = 0;
  while (permission != LocationPermission.granted && retryCount < 5) {
    await Future.delayed(const Duration(milliseconds: 300));
    permission = await Geolocator.checkPermission();
    retryCount++;
  }

  // 确认权限后获取位置
  if (permission == LocationPermission.granted) {
    try {
      return await Geolocator.getCurrentPosition(
        desiredAccuracy: LocationAccuracy.high,
        timeLimit: const Duration(seconds: 10),
      );
    } catch (e) {
      print("获取位置失败: $e");
      return null;
    }
  }
  return null;
}

2. 初始化时触发权限状态同步 #

在应用启动时主动检查权限状态，若已授权则尝试发起一次低精度位置请求，触发WebKit的权限状态同步：

void initLocationSync() async {
  LocationPermission permission = await Geolocator.checkPermission();
  if (permission == LocationPermission.granted) {
    try {
      // 低精度请求，仅用于触发权限同步，无需处理结果
      await Geolocator.getCurrentPosition(
        desiredAccuracy: LocationAccuracy.low,
        timeLimit: const Duration(seconds: 2),
      );
    } catch (_) {
      // 忽略此次请求的异常
    }
  }
}

3. 添加异常场景引导 #

当检测到权限已授权但位置获取失败时，提示用户手动检查Safari权限设置（因为Chrome依赖该设置），示例提示：

无法获取您的位置，请前往「设置 → Safari浏览器 → 位置权限」，将本应用的权限设置为「允许」后，重新打开应用即可正常使用。

验证步骤 #

1. 在iOS设备上打开Safari，清除应用的网站数据（设置-Safari浏览器-清除历史记录与网站数据）
2. 重新加载Flutter Web应用，首次授权位置权限后，验证是否能正常获取位置
3. 若仍失败，按照提示修改Safari权限设置后重试

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