Flutter WorkManager执行Firestore写入时提示未初始化Firebase App问题

你的问题根源在于WorkManager的回调函数运行在独立的Isolate（隔离区）中，主应用Isolate里执行的Firebase.initializeApp()不会作用到这个后台Isolate，因此后台任务中调用Firestore时会提示未初始化Firebase App。

解决步骤： #

在callbackDispatcher的任务执行逻辑中，单独初始化Firebase，确保后台Isolate能访问到Firebase实例。

修改后的callbackDispatcher代码如下：

@pragma('vm:entry-point') // Mandatory if the App is obfuscated or using Flutter 3.1+
void callbackDispatcher() {
  Workmanager().executeTask((taskName, inputData) async {
    switch (taskName) {
      case 'firestore':
        // 关键：在后台任务中单独初始化Firebase
        if (Firebase.apps.isEmpty) {
          await Firebase.initializeApp(
            options: DefaultFirebaseOptions.currentPlatform,
          );
        }

        final productId = inputData!['productId'] ?? '';
        final quantity = inputData!['quantity'] ?? 1; // 保持数值类型，避免转为字符串

        Logger().e("ProductId:: $productId");
        Logger().e("Quantity:: $quantity");
        Logger().e("InputData:: ${jsonEncode(inputData)}");
        Logger().e("UploadCartIdsToFirestoreCalled:: True");

        if (productId.isNotEmpty) {
          Logger().e("AddToFirestoreIfStatementReached:: True");

          final firestoreInstance = FirebaseFirestore.instance;

          try {
            await firestoreInstance.collection('cart').doc(productId).set({
              'quantity': quantity,
            });

            Logger().i("ProductAddedToCartWithId:: $productId");
            return true;
          } catch (e) {
            Logger().e("FailedToAddProductToCart:: $e");
            return false;
          }
        }
        break;
      default:
    }
    return true;
  });
}

关键说明： #

1. Isolate隔离特性：Flutter中WorkManager的后台任务运行在独立Isolate，和主应用的状态、初始化完全隔离，所有依赖库（比如Firebase）都需要在该Isolate内单独初始化。
2. 重复初始化防护：通过Firebase.apps.isEmpty判断，避免多次触发任务时重复初始化Firebase导致报错。
3. 数据类型修正：将quantity的默认值从字符串改为数值1，确保Firestore存储正确的数据类型。

这样修改后，后台任务就能正常初始化Firebase并完成Firestore写入操作。

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