Flutter从Firestore搜索数据在ListView展示时[]操作符报错如何解决？

这个报错由Dart空安全机制触发：Firestore中QueryDocumentSnapshot.data()方法返回的是可空类型Map<String, dynamic>?，无法直接对可能为null的对象执行[]取值操作，同时字段name也可能不存在于返回的文档数据中。

1. 直接修改报错代码行 #

使用空安全运算符?.取值，同时用??设置兜底默认值，修改后的代码如下：

// 原代码
// _querySnapshot.docs[index].data()['name']
// 修改后
(_querySnapshot.docs[index].data() as Map<String, dynamic>?)?['name'] ?? '无名称'

代码逻辑说明：

• 先将data()返回的结果强转为预期的Map<String, dynamic>?类型
• 用?.仅在对象不为空时执行['name']取值
• 用??设置兜底值，当前面取值为null时，自动展示兜底文本无名称

2. 完整的searchedData方法参考 #

Widget searchedData() {
  // 增加列表非空判断，避免空列表渲染报错
  if (_querySnapshot.docs.isEmpty) {
    return const Center(child: Text('未搜到匹配数据', style: TextStyle(color: Colors.white)));
  }
  return ListView.builder(
    itemCount: _querySnapshot.docs.length,
    itemBuilder: (BuildContext context, int index) {
      final docData = _querySnapshot.docs[index].data() as Map<String, dynamic>?;
      final name = docData?['name'] ?? '无名称';
      return ListTile(
        title: Text(
          name,
          style: const TextStyle(color: Colors.white),
        ),
      );
    });
}

额外注意事项 #

• 请确认你的Firestorereports集合下的文档确实存在name字段，如果字段名拼写不一致也会取不到值
• 当前搜索条件是匹配property字段，如果你需要按name搜索，可以把queryData方法中的where条件修改为.where('name', isGreaterThanOrEqualTo: queryString)

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