Flutter应用未启动时如何向Firestore自动添加考勤缺勤数据？

方案一：云端自动处理（推荐，无需依赖App状态） #

用Firebase Cloud Functions实现定时检测，这是最可靠的方式——不管App是否启动都能稳定运行，不需要额外安装Flutter插件（仅需使用Firebase官方的云函数工具链）。

实现步骤： #

1. 初始化Cloud Functions：在本地项目中完成Firebase Cloud Functions的初始化（按Firebase官方流程操作即可）。
2. 创建定时触发云函数：设置一个周期性触发器（比如每5分钟执行一次），覆盖你需要检测的时间窗口。
3. 编写核心检测逻辑：
   • 查询当前时间处于「课程endTime前10分钟到endTime」区间内的所有cours记录。
   • 对每条符合条件的课程，查询对应班级中isPresent=false的users。
   • 将这些用户信息批量写入miss集合，通过user_name+cours_subject+cours_startTime作为文档ID实现去重，避免重复添加同一次课程的同一个用户。

云函数代码示例（Node.js）： #

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

exports.checkAbsentUsers = functions.pubsub.schedule("every 5 minutes").onRun(async (context) => {
  const now = new Date();
  const tenMinutesAgo = new Date(now.getTime() - 10 * 60 * 1000);
  
  // 查询时间符合条件的课程
  const coursQuery = admin.firestore().collection("cours")
    .where("endTime", ">=", tenMinutesAgo)
    .where("endTime", "<=", now);
  
  const coursSnapshot = await coursQuery.get();
  if (coursSnapshot.empty) return;

  // 遍历处理每门课程
  for (const coursDoc of coursSnapshot.docs) {
    const coursData = coursDoc.data();
    const className = coursData.class;
    const subject = coursData.subject;
    const startTime = coursData.startTime;
    const endTime = coursData.endTime;

    // 查询该班级未出勤的用户
    const usersQuery = admin.firestore().collection("users")
      .where("class", "==", className)
      .where("isPresent", "==", false);
    
    const usersSnapshot = await usersQuery.get();
    if (usersSnapshot.empty) continue;

    // 批量写入miss集合
    const batch = admin.firestore().batch();
    usersSnapshot.forEach(userDoc => {
      const userData = userDoc.data();
      const missDocId = `${userData.name}_${subject}_${startTime.toISOString()}`;
      const missRef = admin.firestore().collection("miss").doc(missDocId);
      batch.set(missRef, {
        user_name: userData.name,
        user_class: userData.class,
        cours_subject: subject,
        cours_startTime: startTime,
        cours_endTime: endTime
      }, { merge: true });
    });

    await batch.commit();
  }

  return null;
});

方案二：本地后台任务（依赖App运行权限） #

如果必须在本地处理，需要使用Flutter后台任务插件，但受Android/iOS系统后台限制，可靠性远不如云端方案。

需要安装的插件： #

• workmanager：支持Android周期性后台任务，兼容iOS部分后台模式。
• 或background_fetch：跨平台后台任务插件，支持周期性唤醒。

实现步骤： #

1. 安装并配置插件：按照插件文档完成Android和iOS的权限配置（比如添加后台运行权限、配置iOS后台模式）。
2. 注册后台任务：在App初始化时注册周期性任务，设置触发间隔（比如每15分钟，系统可能会强制调整间隔）。
3. 编写任务逻辑：在后台任务中执行和云端一致的检测流程——查询符合条件的课程、对应班级的未出勤用户、写入miss集合。

Flutter代码示例（workmanager）： #

import 'package:workmanager/workmanager.dart';
import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:flutter/material.dart';

void callbackDispatcher() {
  Workmanager().executeTask((task, inputData) async {
    final now = DateTime.now();
    final tenMinutesAgo = now.subtract(const Duration(minutes: 10));
    
    // 查询时间符合条件的课程
    final coursQuery = FirebaseFirestore.instance.collection('cours')
      .where('endTime', isGreaterThanOrEqualTo: tenMinutesAgo)
      .where('endTime', isLessThanOrEqualTo: now);
    
    final coursSnapshot = await coursQuery.get();
    if (coursSnapshot.docs.isEmpty) return Future.value(true);

    for (final coursDoc in coursSnapshot.docs) {
      final coursData = coursDoc.data();
      final className = coursData['class'];
      final subject = coursData['subject'];
      final startTime = coursData['startTime'] as Timestamp;
      final endTime = coursData['endTime'] as Timestamp;

      // 查询未出勤用户
      final usersQuery = FirebaseFirestore.instance.collection('users')
        .where('class', isEqualTo: className)
        .where('isPresent', isEqualTo: false);
      
      final usersSnapshot = await usersQuery.get();
      if (usersSnapshot.docs.isEmpty) continue;

      // 写入miss集合
      final batch = FirebaseFirestore.instance.batch();
      for (final userDoc in usersSnapshot.docs) {
        final userData = userDoc.data();
        final missDocId = '${userData['name']}_${subject}_${startTime.toDate().toIso8601String()}';
        final missRef = FirebaseFirestore.instance.collection('miss').doc(missDocId);
        batch.set(missRef, {
          'user_name': userData['name'],
          'user_class': userData['class'],
          'cours_subject': subject,
          'cours_startTime': startTime,
          'cours_endTime': endTime
        }, SetOptions(merge: true));
      }
      await batch.commit();
    }

    return Future.value(true);
  });
}

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Workmanager().initialize(
    callbackDispatcher,
    isInDebugMode: false,
  );
  // 注册周期性任务
  await Workmanager().registerPeriodicTask(
    'check-absent-task',
    'checkAbsentUsers',
    frequency: const Duration(minutes: 15),
  );
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(home: Scaffold());
  }
}

注意事项： #

• Android的后台任务受Doze模式限制，无法保证准时触发；iOS仅允许短时间后台执行，应用完全关闭后无法运行任务。
• 本地方案需要用户授予后台权限，部分国产Android厂商会直接限制第三方App的后台任务运行。

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