Flutter中App关闭时AppLifecycleState.detached未触发问题咨询

问题根源 #

AppLifecycleState.detached并非在所有App终止场景下都会触发：

• Android端：当用户直接划掉App、系统因内存不足强制回收进程时，App可能直接终止，不会触发detached状态回调。
• iOS端：App被终止时，系统不会保证detached回调执行完成，异步操作（比如Firestore的update）可能还没完成就被销毁。
• 即使触发detached，该状态下App资源已开始释放，异步IO操作大概率无法正常完成。

可行解决方案 #

1. 结合前台/后台状态切换，优先处理paused状态

将状态更新逻辑同时绑定到paused状态（App退到后台时触发），同时在App回到前台时重置isOnline为true：

@override
void didChangeAppLifecycleState(AppLifecycleState state) {
  final userId = ref.read(currentDeliveryUserProvider)?.reference.id;
  if (userId == null) return;

  switch(state) {
    case AppLifecycleState.resumed:
      // 回到前台时设置在线
      FirebaseFirestore.instance
          .collection(FirebaseConstants.usersCollection)
          .doc(userId)
          .update({'isOnline': true});
      break;
    case AppLifecycleState.paused:
    case AppLifecycleState.detached:
      // 退到后台或终止时设置离线
      onAppClose(userId: userId);
      break;
    default:
      break;
  }
}

2. 使用Firebase Realtime Database的onDisconnect（更可靠）

Firebase Realtime Database提供onDisconnect API，能在客户端与服务器断开连接时（无论正常关闭还是异常崩溃）自动执行写操作。这是处理离线状态的最优方案：

// 在用户登录成功后初始化onDisconnect
void setupOnlineStatus(String userId) {
  final ref = FirebaseDatabase.instance.ref('users/$userId/isOnline');
  
  // 设置当前在线
  ref.set(true);
  
  // 断开连接时自动设置离线
  ref.onDisconnect().set(false);
}

如果必须使用Firestore，可以结合Realtime Database的onDisconnect触发Cloud Function，同步更新Firestore中的状态。

3. 后台任务兜底（针对极端场景）

• Android：使用WorkManager创建延迟任务，当App退到后台后延迟5分钟执行状态更新，如果期间App回到前台则取消任务。
• iOS：使用BackgroundTasks框架注册后台任务，在App终止前争取时间完成状态更新。

注意事项 #

• 避免在生命周期回调中执行耗时异步操作，可将状态更新逻辑封装为独立的隔离任务（Isolate），确保操作不被App终止打断。
• 测试时需模拟真实的App终止场景（比如Android划掉后台、iOS双击Home键关闭），而非仅用IDE的停止按钮。

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