如何解决ChangeNotifier中取消Firebase监听器的LateInitializationError错误

你遇到的两类报错有两个共同根因：

• 调用cancel()时使用的ProductsService实例，不是此前调用过getMenuProducts、已经完成监听器初始化的实例，尤其是在Riverpod管理ChangeNotifier的场景下，自行新建ProductsService()实例会直接触发未初始化/空值报错
• 取消逻辑没有做空安全校验，监听器未初始化时直接调用cancel()就会抛出异常

1. 调整ProductsService实现 #

替换为可空变量+空安全校验逻辑，同时新增重复监听防护、销毁自动清理逻辑：

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

class ProductsService extends ChangeNotifier {
  StreamSubscription<QuerySnapshot>? productsSubscription;

  // 安全取消监听器
  void cancel() {
    productsSubscription?.cancel();
    // 取消后清空变量，避免残留旧监听器引用
    productsSubscription = null;
  }

  void getMenuProducts() async {
    // 每次新建监听前先取消旧监听，避免同时存在多个监听器
    cancel();
    CollectionReference productsReference = FirebaseFirestore.instance.collection('products');
    productsSubscription = productsReference.snapshots().listen(
      (snapshot) => print(snapshot.docs.length),
      // 新增错误处理，触发权限错误时自动取消旧监听器
      onError: (e) {
        if(e.code == 'cloud_firestore/permission-denied') {
          cancel();
        }
      }
    );
  }

  // ChangeNotifier销毁时自动清理监听器
  @override
  void dispose() {
    cancel();
    super.dispose();
  }
}

2. 修正Riverpod调用逻辑 #

调用cancel()时必须使用Riverpod容器管理的同一实例，禁止自行新建ProductsService()实例，登出场景示例调用代码：

// 假设你的Provider定义如下
final productsServiceProvider = ChangeNotifierProvider<ProductsService>((ref) {
  return ProductsService();
});

// 登出逻辑处调用cancel
ref.read(productsServiceProvider).cancel();

3. 可选自动适配用户状态方案 #

如果需要监听器自动跟随账号切换，可在Service内监听Firebase Auth状态，无需手动在登出逻辑调用cancel：

import 'package:firebase_auth/firebase_auth.dart';

class ProductsService extends ChangeNotifier {
  StreamSubscription<QuerySnapshot>? productsSubscription;
  StreamSubscription<User?>? authListener;

  ProductsService() {
    // 监听登录状态变化
    authListener = FirebaseAuth.instance.authStateChanges().listen((user) {
      if (user == null) {
        // 用户登出自动清理监听器
        cancel();
      } else {
        // 新用户登录自动重新拉取数据
        getMenuProducts();
      }
    });
  }

  // 其余cancel、getMenuProducts方法和上面一致

  @override
  void dispose() {
    authListener?.cancel();
    cancel();
    super.dispose();
  }
}

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