Flutter Web 使用cloud_firestore报NoSuchMethodError求解决

运行Flutter Web项目时，控制台抛出未捕获的Promise错误，错误详情为：
Uncaught (in promise) Error: [cloud_firestore/unknown] NoSuchMethodError: invalid member on null: 'includeMetadataChanges'
错误参考截图：

项目现有相关配置 #

• pubspec.yaml 中的关联依赖配置：

firebase_storage: ^7.0.0

• index.html 中引入的Firebase JS SDK均为8.2.3版本，引入代码如下：

<script src="https://www.gstatic.com/firebasejs/8.2.3/firebase-app.js"></script>
<script src="https://www.gstatic.com/firebasejs/8.2.3/firebase-auth.js"></script>
<script src="https://www.gstatic.com/firebasejs/8.2.3/firebase-analytics.js"></script>
<script src="https://www.gstatic.com/firebasejs/8.2.3/firebase-firestore.js"></script>

• 触发报错的业务Dart代码如下：

class UserNotifier extends StateNotifier<List<UserModel>> {
  UserNotifier([List<UserModel>? state])
      : super(state = <UserModel>[]) {     
    fatchData(); // 逻辑等同于initState，在实例初始化阶段执行数据拉取操作
  }
  
  Future fatchData() async {
    QuerySnapshot snapshot =
        await FirebaseFirestore.instance.collection('Users').get();
    final List<UserModel> users = [];
    snapshot.docs.forEach((document) {
      UserModel _user = UserModel.fromSnapshot(document);
      users.add(_user);
    });
  }
}

排查进展 #

已核查业务侧涉及的目标数据，确认数据本身不存在空值场景，目前暂未定位到该运行时错误的解决路径，寻求可落地的技术指导。

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