升级Flutter依赖后拉取Firestore数据出现Bad state错误如何解决？

该报错由cloud_firestore 2.0.0+版本的API不兼容变更导致，新版DocumentSnapshot不再支持直接通过下标读取字段，必须先调用.data()方法获取完整的字段映射后再取值。你之前尝试的方案混淆了QuerySnapshot和DocumentSnapshot的API：FutureBuilder返回的snapshot.data是QuerySnapshot对象，直接取docs属性即可，不需要调用data()方法，需要修改的是Users类的字段读取逻辑。

1. 修改Users类的fromDocument实现 #

import 'package:cloud_firestore/cloud_firestore.dart';

class Users {
  String id;
  String email;
  String tag;

  Users({
    required this.id,
    required this.email,
    required this.tag
  });

  factory Users.fromDocument(DocumentSnapshot doc) {
    // 先获取文档字段映射
    Map<String, dynamic> docData = doc.data() as Map<String, dynamic>;
    return Users(
      id: doc.id,
      email: docData['email'],
      tag: docData['tag']
    );
  }
}

如果项目开启了空安全且字段可能不存在，可补充默认值避免空异常：

email: docData['email'] ?? '',
tag: docData['tag'] ?? '',

2. 优化FutureBuilder逻辑 #

补充泛型约束和非空判断，避免运行时类型错误：

buildResults() {
  return FutureBuilder<QuerySnapshot>(
    future: searchResultsFuture,
    builder: (context, snapshot) {
      if (snapshot.connectionState != ConnectionState.done) {
        return SizedBox(
          child: CircularProgressIndicator(),
        );
      }
      // 无数据时返回占位
      if (!snapshot.hasData || snapshot.data!.docs.isEmpty) {
        return Center(child: Text("未找到匹配结果"));
      }
      List<UserResult> searchResults = [];
      // QuerySnapshot直接取docs属性，不需要调用data()
      snapshot.data!.docs.forEach((doc) {
        Users user = Users.fromDocument(doc);
        UserResult searchResult = UserResult(user);
        searchResults.add(searchResult);
      });
      return SingleChildScrollView(
        child: Column(
          children: searchResults,
        ),
      );
    },
  );
}

3. 修复TextFormField的事件绑定错误 #

原代码中onFieldSubmitted直接调用了方法，会在页面构建时就触发搜索，改为回调写法：

TextFormField(
  enableInteractiveSelection: true,
  controller: searchController,
  keyboardType: TextInputType.text,
  onFieldSubmitted: (value) => handleSearch(value),
),

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