如何确保Flutter前台WebSocket位置服务长期稳定运行不中断？

我开发了一款应用，需要持续实时追踪并向服务器分享用户的位置与速度。为此，应用运行Foreground Service并使用WebSocket实现实时数据共享，但遇到两大挑战：

• 尝试发送数据时设备可能失去网络连接；
• 用户数小时未使用手机导致设备屏幕熄灭。

已采取的解决思路 #

• 针对第一个挑战：设备无网络时，数据临时存储至本地数据库；网络恢复后自动将存储数据发送至服务器。
• 针对第二个挑战：向用户申请额外权限并配置到Manifest.xml中，如android.permission.WAKE_LOCK（保持设备唤醒）和android.permission.ACCESS_BACKGROUND_LOCATION（后台接收位置更新）。

当前问题 #

应用可正常接收数据约1.5小时，但之后前台服务无法继续运行，最终被终止。

代码片段 #

我使用了flutter_foreground_task包。以下是CustomTaskHandler类的代码片段，在onRepeatEvent方法中向服务器发送数据：该方法获取用户当前位置并尝试通过WebSocket发送；若传输失败则将数据保存至本地数据库。

class CustomTaskHandler extends TaskHandler {
...
  @override
  void onRepeatEvent(DateTime timestamp, SendPort? sendPort) async {
    final locationData = await locationService.getCurrentLocation();
    if (locationData != null) {
      log(">> Current Location: (${locationData.latitude}, ${locationData.longitude})");
      FlutterForegroundTask.updateService(
        notificationTitle: 'Current Location ($count): (${locationData.latitude}, ${locationData.longitude})',
      );

      final formattedTimestamp = DateFormat('yyyy-MM-dd HH:mm:ss').format(timestamp);
      final locationMap = {
        'latitude': locationData.latitude,
        'longitude': locationData.longitude,
        'speed': locationData.speed,
        'created_at': formattedTimestamp.toString()
      };
      final hasInternetConnection = await checkInternetConnection();
      if (hasInternetConnection) {
        log(">> Send via websocket.");
        _initWebsocket();
        websocket.sendMessage(locationMap);
      } else {
        locationRepository.insertRecord(
          speed: locationMap['speed'].toString(),
          latitude: locationMap['latitude'].toString(),
          longitude: locationMap['longitude'].toString(),
          createdAt: locationMap['created_at'].toString(),
        )
        .then((_) => log(">> Record inserted successfully"))
        .catchError((error) => log(">> Error inserting record: $error"));
      }

      sendPort?.send(locationMap);
    }
  }
}

完整代码及演示可在我的仓库中查看。

技术问询 #

恳请提供解决方案，确保Foreground Service可持续运行并传输数据不中断，尤其是设备长期闲置或未被使用的场景下。

1. 强化前台服务的系统优先级 #

• 在AndroidManifest.xml的服务声明里，添加android:foregroundServiceType="location"，同时设置android:priority="2147483647"（最高优先级）。Android 12+要求前台服务必须指定类型，明确标注定位类型能降低系统回收概率。
• 初始化flutter_foreground_task时，把notificationPriority设为NotificationPriority.MAX，同时开启内置的wakelock选项——单独的WAKE_LOCK权限不足以对抗系统的资源回收，结合插件的唤醒配置更可靠。

2. 修复WebSocket重复初始化问题 #

你现在每次触发onRepeatEvent都调用_initWebsocket()，会重复创建连接，既浪费资源又可能引发连接泄漏，触发系统回收。改成：

• 只在WebSocket未连接/断开时才初始化；
• 给WebSocket加状态监听，断开后自动重连，避免每次事件都重建连接。

3. 优化位置获取逻辑 #

• 别每次事件都调用getCurrentLocation()，改用locationService.onLocationChanged.listen()监听位置更新，减少频繁调用的资源消耗，效率更高。
• 根据需求配置位置更新的间隔和精度，比如不需要厘米级精度就调低参数，降低电量消耗——高耗电是系统终止后台服务的常见原因。

4. 绕过系统电池优化 #

• 引导用户把应用加入电池优化白名单，代码里可以跳转至系统设置页面提示操作。很多安卓厂商的默认电池优化会在闲置时强杀后台服务，白名单能避免这个问题。
• Android 13+必须申请POST_NOTIFICATIONS权限，确保前台服务的通知正常显示——如果通知被屏蔽，系统会判定前台服务无效并终止。

5. 本地数据批量上传优化 #

• 网络恢复后不要一次性传完所有缓存数据，分批次上传，避免单次数据量过大导致连接超时或资源过载。
• 给本地数据加上传状态标记，确保已上传的数据不会重复发送，上传失败的重新加入队列。

6. 服务兜底保活 #

• 用WorkManager（安卓）或BackgroundFetch（跨平台）做兜底，定期检查前台服务是否运行，一旦终止就重启。
• 别在onRepeatEvent里做耗时操作，数据库插入、WebSocket发送这类异步任务要避免阻塞事件循环，必要时用单独的Isolate处理。

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