Flutter后台服务调用_getLocation获取位置失败求助

问题描述 #

Flutter应用需要在后台或被移除最近列表后定期获取用户当前位置，使用flutter_background_service实现后台运行，通知显示时间功能正常，但在onStart回调中调用_getLocation函数时出现Failed to handle method call错误，UI中调用该函数却能正常工作。

相关代码片段 #

位置获取函数：

Future<LocationData> _getLocation(Location location) async {
  final locationResult = await location.getLocation();
  LocationData? _location = locationResult;
  print('location print - ${_location}');
  return _location; 
}

后台服务启动核心回调：

@pragma('vm:entry-point')
void onStart(ServiceInstance service) async {
  DartPluginRegistrant.ensureInitialized();

  Location location = Location();
  LocationData? _location;

  // 定时器定期执行位置获取
  Timer.periodic(const Duration(seconds: 3), (timer) async {
    _location = await _getLocation(location);
    // 后续数据处理逻辑...
  });
}

完整代码见用户提供的示例。

错误日志 #

E/MethodChannel#lyokone/location(28616): Failed to handle method call
E/MethodChannel#lyokone/location(28616): java.lang.NullPointerException: Attempt to write to field 'io.flutter.plugin.common.MethodChannel$Result com.lyokone.location.FlutterLocation.getLocationResult' on a null object reference
E/MethodChannel#lyokone/location(28616):    at com.lyokone.location.MethodCallHandlerImpl.onGetLocation(MethodCallHandlerImpl.java:117)
...
E/flutter (28616): #4      _getLocation (package:track_my_people/main.dart:269:26)
E/flutter (28616): #5      onStart (package:track_my_people/main.dart:140:15)
E/flutter (28616): <asynchronous suspension>

解决方案 #

核心原因 #

后台服务运行在独立的Dart Isolate中，默认的DartPluginRegistrant.ensureInitialized()未完成location插件的注册，导致原生层的FlutterLocation实例为空，触发空指针异常。

修复步骤 #

1. 手动注册Location插件的MethodChannel
   在onStart函数中添加手动注册逻辑，确保后台Isolate能正确连接到原生插件：

   @pragma('vm:entry-point')
   void onStart(ServiceInstance service) async {
     WidgetsFlutterBinding.ensureInitialized();
     DartPluginRegistrant.ensureInitialized();
   
     // 手动注册Location插件的MethodChannel
     const MethodChannel locationChannel = MethodChannel('lyokone/location');
     locationChannel.setMethodCallHandler((call) async => null);
   
     // 原有代码继续执行
     Location location = Location();
     // ...
   }
   

2. 完善权限配置
   检查AndroidManifest.xml，确保添加必要权限：

   <!-- 基础位置权限 -->
   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
   <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
   <!-- Android 10+ 后台位置权限 -->
   <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
   <!-- 前台服务权限 -->
   <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
   <uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />
   

3. 添加权限与服务状态检查
   在获取位置前，先确认权限已授予、位置服务已开启：

   Future<LocationData> _getLocation(Location location) async {
     // 检查并请求位置权限
     PermissionStatus permission = await location.hasPermission();
     if (permission != PermissionStatus.granted) {
       permission = await location.requestPermission();
       if (permission != PermissionStatus.granted) {
         throw Exception("位置权限未授予");
       }
     }
   
     // 检查并请求开启位置服务
     bool isServiceEnabled = await location.serviceEnabled();
     if (!isServiceEnabled) {
       isServiceEnabled = await location.requestService();
       if (!isServiceEnabled) {
         throw Exception("位置服务未开启");
       }
     }
   
     return await location.getLocation();
   }
   

4. 更新依赖版本
   使用最新稳定版插件，避免兼容性问题：

   dependencies:
     flutter_background_service: ^5.0.5
     location: ^5.0.3
   

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