Flutter+Firebase设备订阅服务：如何远程强制登出旧设备

核心思路 #

Firebase Auth本身没有原生的远程强制登出API，但可以通过Firestore实时监听订阅文档变化的方式，让旧设备主动检测到订阅已被抢占，从而触发本地登出逻辑。整体流程分为三步：新设备抢占订阅更新deviceID → 旧设备实时监听文档变更 → 旧设备触发强制登出。

具体实现步骤 #

1. 新设备的订阅抢占逻辑

当用户在新设备选择已被占用的订阅时，直接更新Firestore中该订阅文档的deviceID为当前设备ID（需确保订阅状态为active）：

// 获取当前设备ID的工具方法（可使用device_info_plus包实现）
Future<String> getCurrentDeviceId() async {
  final deviceInfo = DeviceInfoPlugin();
  if (Platform.isAndroid) {
    final androidInfo = await deviceInfo.androidInfo;
    return androidInfo.id;
  } else if (Platform.isIOS) {
    final iosInfo = await deviceInfo.iosInfo;
    return iosInfo.identifierForVendor!;
  }
  return UniqueKey().toString();
}

// 尝试抢占订阅
Future<bool> takeOverSubscription(String subscriptionId) async {
  try {
    final currentDeviceId = await getCurrentDeviceId();
    final subscriptionDoc = FirebaseFirestore.instance
        .collection('subscription')
        .doc(subscriptionId);

    // 原子更新：仅允许更新deviceID和更新时间，确保操作安全
    await subscriptionDoc.update({
      'deviceID': currentDeviceId,
      'lastUpdated': FieldValue.serverTimestamp(),
    });

    // 保存当前订阅到本地缓存
    final prefs = await SharedPreferences.getInstance();
    await prefs.setString('active_subscription_id', subscriptionId);
    return true;
  } catch (e) {
    // 处理异常：比如订阅已被暂停、无权限更新等
    debugPrint('抢占订阅失败: $e');
    return false;
  }
}

2. 旧设备的实时监听与强制登出

旧设备在用户选中订阅后，持续监听该订阅文档的变化，一旦发现deviceID与当前设备不匹配，立即执行登出并清理本地状态：

// 启动订阅监听
void startSubscriptionListener(String subscriptionId) {
  FirebaseFirestore.instance
      .collection('subscription')
      .doc(subscriptionId)
      .snapshots()
      .listen((snapshot) async {
    if (!snapshot.exists) return;
    final data = snapshot.data()!;
    final currentDeviceId = await getCurrentDeviceId();

    // 检测到订阅已被其他设备占用
    if (data['deviceID'] != null && data['deviceID'] != currentDeviceId) {
      await _forceSignOut();
    }
  });
}

// 强制登出逻辑
Future<void> _forceSignOut() async {
  // 登出Firebase Auth
  await FirebaseAuth.instance.signOut();
  
  // 清除本地缓存的订阅信息
  final prefs = await SharedPreferences.getInstance();
  await prefs.remove('active_subscription_id');
  
  // 跳转到登录/订阅选择页面
  if (mounted) {
    Navigator.of(context).pushReplacementNamed('/login');
    // 提示用户
    ScaffoldMessenger.of(context).showSnackBar(
      const SnackBar(content: Text('您的订阅已被其他设备占用，请重新选择')),
    );
  }
}

3. Firestore安全规则限制

添加安全规则，确保只有认证用户能更新订阅，且仅允许修改deviceID和lastUpdated字段，同时验证订阅状态为active：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /subscription/{subscriptionId} {
      allow update: if request.auth != null 
                  && resource.data.subscriptionStatus == 'active'
                  && request.resource.data.keys().hasOnly(['deviceID', 'lastUpdated']);
    }
  }
}

关键注意事项 #

• 监听时机：用户选中订阅后立即启动监听，确保全程实时同步订阅状态。
• 并发处理：使用Firestore的原子更新操作，避免多设备同时抢占导致的数据冲突。
• 权限控制：通过安全规则防止未授权用户修改订阅信息，保障数据安全。

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