如何判断用户是否正在使用App（区分在线/离线状态）

核心思路 #

放弃单纯依赖isOnline布尔字段的方案，改用App生命周期监听+心跳时间戳组合实现：

• 前台活跃时标记在线并持续更新最后活跃时间
• 后台/退应用时标记离线并更新最后活跃时间
• 针对意外杀进程的情况，通过「最后活跃时间是否在阈值内」来修正状态判断

具体实现步骤 #

1. 调整Firestore数据结构 #

将原有的isOnline字段，搭配新增的lastActive毫秒级UTC时间戳字段使用，文档结构示例：

{
  "userId": "xxx",
  "isOnline": true,
  "lastActive": 1718923456000 // 记录最后活跃的时间戳
}

2. Flutter端监听App生命周期 #

通过WidgetsBindingObserver捕捉前后台切换，实时同步状态到Firestore，同时加入心跳机制确保前台活跃状态的准确性：

class _HomePageState extends State<HomePage> with WidgetsBindingObserver {
  final FirebaseFirestore _firestore = FirebaseFirestore.instance;
  late String _currentUserId;
  late Timer _heartbeatTimer;

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
    _currentUserId = FirebaseAuth.instance.currentUser!.uid;
    // 初始化时标记在线
    _updateUserStatus(isOnline: true);
  }

  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    _stopHeartbeat();
    // 页面销毁时标记离线
    _updateUserStatus(isOnline: false);
    super.dispose();
  }

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    super.didChangeAppLifecycleState(state);
    switch (state) {
      case AppLifecycleState.resumed:
        _updateUserStatus(isOnline: true);
        _startHeartbeat();
        break;
      case AppLifecycleState.paused:
      case AppLifecycleState.inactive:
      case AppLifecycleState.detached:
        _updateUserStatus(isOnline: false);
        _stopHeartbeat();
        break;
    }
  }

  // 更新用户状态到Firestore
  Future<void> _updateUserStatus({required bool isOnline}) async {
    await _firestore.collection('users').doc(_currentUserId).update({
      'isOnline': isOnline,
      'lastActive': DateTime.now().millisecondsSinceEpoch,
    });
  }

  // 心跳：每30秒更新一次最后活跃时间，确保前台状态持续有效
  void _startHeartbeat() {
    _heartbeatTimer = Timer.periodic(const Duration(seconds: 30), (timer) {
      _firestore.collection('users').doc(_currentUserId).update({
        'lastActive': DateTime.now().millisecondsSinceEpoch,
      });
    });
  }

  void _stopHeartbeat() {
    if (_heartbeatTimer.isActive) _heartbeatTimer.cancel();
  }
}

3. 客户端判断在线状态逻辑 #

结合isOnline字段和lastActive时间戳，设置阈值（比如1分钟）来避免意外退出导致的误判：

// 假设已获取目标用户的Firestore文档数据
Map<String, dynamic> userData = ...;

// 定义在线阈值：最后活跃时间在60秒内则判定为在线
const int onlineThreshold = 60000;

bool isOnline = userData['isOnline'] == true &&
    (DateTime.now().millisecondsSinceEpoch - userData['lastActive']) < onlineThreshold;

然后在UI中使用该状态：

Text(
  isOnline ? "Online" : "Offline",
  style: TextStyle(color: isOnline ? Colors.green : Colors.grey),
),

4. 意外退出场景处理 #

如果用户直接杀死App（未触发生命周期回调），isOnline会残留为true，但lastActive不会更新。此时通过时间戳差值超过阈值的判断逻辑，会自动将状态修正为离线，解决误显示问题。

补充说明 #

• 心跳间隔可根据需求调整（30秒~1分钟），平衡实时性和Firestore读写成本
• 也可以完全移除isOnline字段，仅通过lastActive与当前时间的差值判断在线状态
• iOS端需注意后台挂起限制，挂起后心跳会停止，此时lastActive会停留在挂起前的时间，客户端会正确判定为离线

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