Flutter使用flutter_background_service实现后台10秒定时获取位置功能失效求助

嗨，我之前也踩过flutter_background_service后台定位的坑，看了你的代码和问题描述，给你几个针对性的解决方案，应该能帮你搞定这个问题：

1. 补全Android后台定位权限（最容易忽略的核心点） #

Android 12及以上版本对后台定位有严格的权限限制，你大概率只配置了前台定位权限，漏掉了关键的后台权限：

• 先在android/app/src/main/AndroidManifest.xml里添加后台定位权限：

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

• 必须在运行时主动请求这个权限，因为后台定位权限需要用户手动授权，不能只靠清单文件。你可以在初始化服务前，先调用Geolocator的权限请求逻辑：

LocationPermission permission = await Geolocator.checkPermission();
if (permission == LocationPermission.denied) {
  permission = await Geolocator.requestPermission();
}
// 额外请求后台定位权限（针对仅允许前台定位的情况）
if (permission == LocationPermission.whileInUse) {
  permission = await Geolocator.requestPermission();
}

2. 替换Timer.periodic为Geolocator位置流（更可靠的后台定时方案） #

Timer.periodic在后台很容易被Android系统的休眠机制打断，换成Geolocator自带的位置流会稳定得多——它会和系统定位服务绑定，不容易被系统杀死。修改你onStart方法里的定时逻辑：

@pragma('vm:entry-point')
static Future<void> onStart(ServiceInstance service) async {
  if (service is AndroidServiceInstance) {
    service.setAsForegroundService();
    service.setForegroundNotificationInfo(
      title: "Live Tracking",
      content: "Service running...",
    );
    service.setAutoStartOnBootMode(true);
  }

  // 用位置流替代Timer，避免后台被休眠打断
  StreamSubscription<Position>? positionSubscription;
  try {
    final locationSettings = LocationSettings(
      accuracy: LocationAccuracy.high,
      intervalDuration: Duration(seconds: 10), // 每10秒触发一次
      distanceFilter: 0, // 忽略移动距离，严格按时触发
    );
    positionSubscription = Geolocator.getPositionStream(locationSettings: locationSettings)
        .listen((Position position) async {
      try {
        final ok = await TrackingDelegateFun(
          position.latitude.toString(),
          position.longitude.toString(),
        );
        print("***********sent ${position.latitude}, ${position.longitude} => $ok");
      } catch (e) {
        print("提交位置失败: ${e.toString()}");
      }
    });
  } catch (e) {
    print("启动位置流失败: ${e.toString()}");
  }

  // 服务停止时记得取消订阅，避免内存泄漏
  service.onServiceDispose.listen((_) {
    positionSubscription?.cancel();
  });
}

3. 处理国产手机的电池优化白名单 #

小米、华为、OPPO等国产厂商的电池优化机制会直接杀死后台服务，哪怕你配置了所有权限。你需要引导用户把应用加入电池优化白名单，也可以在代码里主动请求：

• 先在AndroidManifest.xml加权限：

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

• 然后在初始化服务前检查并请求：

import 'package:device_info_plus/device_info_plus.dart';

// 检查是否在电池优化白名单
final deviceInfo = DeviceInfoPlugin();
final androidInfo = await deviceInfo.androidInfo;
final isIgnoring = await androidInfo.isIgnoringBatteryOptimizations;
if (!isIgnoring) {
  await androidInfo.requestIgnoreBatteryOptimizations();
}

4. 别再吞掉异常了！ #

你的代码里catch块是空的，这会让你完全不知道后台定位失败的真实原因。一定要在catch里打印错误信息，比如：

catch (e) {
  print("定位异常详情: ${e.toString()}");
}

这样你就能快速定位是权限不够、系统限制，还是定位服务本身的问题。

5. 优化flutter_background_service的Android配置 #

确保你的Android配置里服务优先级足够高，可以在configure时加上通知ID：

androidConfiguration: AndroidConfiguration(
  onStart: onStart,
  isForegroundMode: true,
  autoStart: true,
  // 固定通知ID，避免系统回收通知导致服务降级
  foregroundServiceNotificationId: 1001,
),

按照这几个步骤修改后，应该能解决后台定时定位失效的问题。记得在不同Android版本（尤其是12+）和国产设备上多测试，因为不同厂商的后台限制差异很大。

内容来源于stack exchange