Flutter使用geolocator^7.7.0获取用户位置报MissingPluginException如何解决

该MissingPluginException报错为geolocator库依赖未正确安装、平台权限未配置、缺少权限校验逻辑导致，按照以下步骤处理即可：

1. 重装依赖并重新编译 #

• 执行 flutter clean 清理项目缓存
• 执行 flutter pub get 重新拉取依赖
• 完全关闭当前运行的应用，重新编译启动，禁止使用热重载/热重启生效配置

2. 配置安卓平台参数 #

2.1 调整最低SDK版本 #

编辑android/app/build.gradle，将minSdkVersion调整为≥19，符合geolocator 7.x版本要求：

android {
    defaultConfig {
        minSdkVersion 19
        // 其余原有配置保持不变
    }
}

2.2 添加定位权限 #

编辑android/app/src/main/AndroidManifest.xml，在<manifest>标签内（不要放在<application>标签内）添加权限配置：

<!-- 基础定位权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 如需后台定位可添加以下权限，无需求可省略 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

3. 配置iOS平台权限 #

编辑ios/Runner/Info.plist，在<dict>标签内添加权限说明配置：

<!-- 前台定位权限说明，可自行修改提示文案 -->
<key>NSLocationWhenInUseUsageDescription</key>
<string>需要获取您的位置完成服务校验</string>
<!-- 如需后台定位可添加以下配置，无需求可省略 -->
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>需要后台获取您的位置完成服务校验</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>需要后台获取您的位置完成服务校验</string>

4. 完整可运行代码 #

原代码缺少定位服务检测、权限校验逻辑，直接调用获取位置方法会触发报错，以下为包含位置获取、服务端上传的完整逻辑：
首先导入所需依赖：

import 'package:geolocator/geolocator.dart';
// 如需上传到服务端，需在pubspec.yaml引入http: ^0.13.5依赖，再导入以下包
import 'package:http/http.dart' as http;

功能实现代码：

// 核心方法：获取位置并上传到服务端
Future<void> getCurrentLocationAndUpload() async {
  // 检测定位服务是否开启
  bool isServiceEnabled = await Geolocator.isLocationServiceEnabled();
  if (!isServiceEnabled) {
    print("错误：定位服务未开启，请先开启设备定位");
    return;
  }

  // 检测并申请定位权限
  LocationPermission permission = await Geolocator.checkPermission();
  if (permission == LocationPermission.denied) {
    permission = await Geolocator.requestPermission();
    if (permission == LocationPermission.denied) {
      print("错误：定位权限被用户拒绝");
      return;
    }
  }

  if (permission == LocationPermission.deniedForever) {
    print("错误：定位权限被永久拒绝，请前往系统设置手动开启权限");
    return;
  }

  // 权限校验通过，获取当前位置
  try {
    Position position = await Geolocator.getCurrentPosition(
      desiredAccuracy: LocationAccuracy.high,
      timeLimit: const Duration(seconds: 10), // 设置超时时间，避免无定位信号时长时间等待
    );
    double latitude = position.latitude;
    double longitude = position.longitude;
    print("位置获取成功：纬度 $latitude，经度 $longitude");

    // 调用上传方法将位置发送到服务端
    await uploadLocation(latitude, longitude);
  } catch (e) {
    print("位置获取失败：$e");
  }
}

// 位置上传到服务端示例方法
Future<void> uploadLocation(double lat, double lng) async {
  try {
    final response = await http.post(
      Uri.parse("替换为你的服务端API接口地址"),
      body: {
        "latitude": lat.toString(),
        "longitude": lng.toString(),
        // 可根据服务端要求补充其他参数，比如用户ID、设备标识等
      },
    );
    if (response.statusCode == 200) {
      print("位置上传成功");
    } else {
      print("位置上传失败，服务端响应码：${response.statusCode}");
    }
  } catch (e) {
    print("位置上传请求出错：$e");
  }
}

需要调用功能时，直接执行 await getCurrentLocationAndUpload() 即可。

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