Flutter Android应用因后台服务启动超时崩溃求助

问题核心 #

崩溃日志触发ForegroundServiceDidNotStartInTimeException，本质是调用Context.startForegroundService()后未在5秒内执行Service.startForeground()，问题指向flutter_background_service插件的服务启动逻辑。

用户提供的依赖清单 #

flutter_background_service: ^5.0.5
flutter_background: ^1.2.0
flutter_ringtone_player: ^3.2.0
flutter_webrtc: ^0.9.35
firebase_core: ^2.24.2
cloud_firestore: ^4.14.0
firebase_messaging: ^14.7.10
firebase_database: ^10.4.0
awesome_notifications_core: ^0.9.1 
awesome_notifications: any

用户提供的崩溃日志 #

D/FlutterWebRTCPlugin(17231): Stopping the audio manager...
D/AndroidRuntime(17231): Shutting down VM
E/AndroidRuntime(17231): FATAL EXCEPTION: main
E/AndroidRuntime(17231): Process: com.xxxx.xxxx, PID: 17231
E/AndroidRuntime(17231): android.app.RemoteServiceException$ForegroundServiceDidNotStartInTimeException: Context.startForegroundService() did not then call Service.startForeground(): ServiceRecord{5b24383 u0 com.zioninvasion.prayer_buddy/id.flutter.flutter_background_service.BackgroundService}
E/AndroidRuntime(17231):    at android.app.ActivityThread.generateForegroundServiceDidNotStartInTimeException(ActivityThread.java:2104)
E/AndroidRuntime(17231):    at android.app.ActivityThread.throwRemoteServiceException(ActivityThread.java:2075)
E/AndroidRuntime(17231):    at android.app.ActivityThread.-$$Nest$mthrowRemoteServiceException(Unknown Source:0)
E/AndroidRuntime(17231):    at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2369)
E/AndroidRuntime(17231):    at android.os.Handler.dispatchMessage(Handler.java:106)
E/AndroidRuntime(17231):    at android.os.Looper.loopOnce(Looper.java:205)
E/AndroidRuntime(17231):    at android.os.Looper.loop(Looper.java:294)
E/AndroidRuntime(17231):    at android.app.ActivityThread.main(ActivityThread.java:8177)
E/AndroidRuntime(17231):    at java.lang.reflect.Method.invoke(Native Method)
E/AndroidRuntime(17231):    at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:552)
E/AndroidRuntime(17231):    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:971)
E/AndroidRuntime(17231): Caused by: android.app.StackTrace: Last startServiceCommon() call for this service was made here
E/AndroidRuntime(17231):    at android.app.ContextImpl.startServiceCommon(ContextImpl.java:1952)
E/AndroidRuntime(17231):    at android.app.ContextImpl.startForegroundService(ContextImpl.java:1906)
E/AndroidRuntime(17231):    at android.content.ContextWrapper.startForegroundService(ContextWrapper.java:830)
E/AndroidRuntime(17231):    at androidx.core.content.ContextCompat$Api26Impl.startForegroundService(ContextCompat.java:1189)
E/AndroidRuntime(17231):    at androidx.core.content.ContextCompat.startForegroundService(ContextCompat.java:752)
E/AndroidRuntime(17231):    at id.flutter.flutter_background_service.FlutterBackgroundServicePlugin.start(FlutterBackgroundServicePlugin.java:82)
E/AndroidRuntime(17231):    at id.flutter.flutter_background_service.FlutterBackgroundServicePlugin.onMethodCall(FlutterBackgroundServicePlugin.java:121)
E/AndroidRuntime(17231):    at io.flutter.plugin.common.MethodChannel$IncomingMethodCallHandler.onMessage(MethodChannel.java:267)
E/AndroidRuntime(17231):    at io.flutter.embedding.engine.dart.DartMessenger.invokeHandler(DartMessenger.java:295)
E/AndroidRuntime(17231):    at io.flutter.embedding.engine.dart.DartMessenger.lambda$dispatchMessageToQueue$0$io-flutter-embedding-engine-dart-DartMessenger(DartMessenger.java:322)
E/AndroidRuntime(17231):    at io.flutter.embedding.engine.dart.DartMessenger$$ExternalSyntheticLambda0.run(Unknown Source:12)
E/AndroidRuntime(17231):    at android.os.Handler.handleCallback(Handler.java:958)
E/AndroidRuntime(17231):    at android.os.Handler.dispatchMessage(Handler.java:99)
E/AndroidRuntime(17231):    ... 6 more
I/Process (17231): Sending signal. PID: 17231 SIG: 9
Lost connection to device.

解决步骤 #

• 移除冲突依赖：同时使用flutter_background_service和flutter_background会导致后台服务逻辑冲突，删除flutter_background: ^1.2.0，仅保留flutter_background_service作为后台服务依赖。

• 完善前台服务通知配置：Android要求前台服务必须显示通知，初始化flutter_background_service时需配置完整的通知参数，示例代码：

Future<void> initializeService() async {
  final service = FlutterBackgroundService();
  await service.configure(
    androidConfiguration: AndroidConfiguration(
      onStart: onStart,
      autoStart: true,
      isForegroundMode: true,
      // Android 8.0+必须配置通知渠道ID
      notificationChannelId: 'background_service_channel',
      initialNotificationTitle: '应用后台运行中',
      initialNotificationContent: '服务保持活跃',
      notificationIcon: '@mipmap/ic_launcher', // 替换为你的应用图标
    ),
    iosConfiguration: IosConfiguration(
      autoStart: true,
      onForeground: onStart,
      onBackground: onIosBackground,
    ),
  );
}

// 后台服务启动回调，优先执行前台服务通知逻辑
@pragma('vm:entry-point')
void onStart(ServiceInstance service) {
  if (service is AndroidServiceInstance) {
    // 先设置前台通知，避免超时
    service.setForegroundNotificationInfo(
      title: '后台服务运行中',
      content: '当前状态：正常',
    );
  }

  // 耗时业务逻辑放在异步任务中，避免阻塞启动流程
  Future.delayed(Duration.zero, () {
    // 执行你的后台任务
  });
}

• 添加必要权限：在android/app/src/main/AndroidManifest.xml中添加前台服务和通知权限：

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

• 升级插件版本：将flutter_background_service升级到最新稳定版，旧版本可能存在启动超时的已知bug，执行flutter pub upgrade flutter_background_service完成更新。

• 避免启动时阻塞：在onStart回调中不要直接执行耗时操作（如网络请求、大量计算），将这些逻辑放在Future.delayed或异步函数中，确保startForeground相关代码优先执行。

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