Flutter使用Firestore StreamBuilder出现Null check operator报错如何解决

StreamBuilder的builder回调会在多个节点触发：初始渲染时stream还未返回查询结果，此时snapshot.data为null，你直接使用!空断言强制要求值非空，就会抛出_CastError异常。首次运行未报错大概率是前序运行缓存了Firestore的查询结果，重启后缓存清空就触发了问题。

你需要在builder中优先处理加载、错误分支，确认拿到有效数据后再渲染列表：

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

class HomePage extends StatefulWidget {
  const HomePage({ Key? key }) : super(key: key);

  @override
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {

  FirebaseFirestore firestore = FirebaseFirestore.instance;
  CollectionReference users = FirebaseFirestore.instance.collection('users');
  Stream<QuerySnapshot<Map<String, dynamic>>> collectionStream = FirebaseFirestore.instance.collection('users').snapshots();

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Home Page'),
      ),
      body: StreamBuilder<QuerySnapshot<Map<String, dynamic>>>(
        stream: collectionStream,
        builder: (context, snapshot) {
          // 处理错误状态
          if (snapshot.hasError) {
            return Center(child: Text('加载失败：${snapshot.error.toString()}'));
          }
          // 处理加载中状态
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }
          // 到此处可确认snapshot.data非空，直接取用
          final QuerySnapshot<Map<String, dynamic>> querySnapshot = snapshot.data!;
          return Container(
            child: ListView.builder(
                itemCount: querySnapshot.docs.length,
                itemBuilder: (context,  index) {
                  final doc = querySnapshot.docs[index];
                  return ListTile(
                    // 字段也做兜底处理，避免不存在name字段时报错
                    title: Text(doc.data()['name'] ?? '无名称'),
                    trailing: IconButton(
                      icon: const Icon(Icons.delete),
                      onPressed: () {
                        users.doc(doc.id).delete();
                      },
                    ),
                  );
                }
            ),
          );
        },
      ),
    );
  }
}

• 可以在删除操作前加确认弹窗，避免误删
• 如果列表可能为空，可以判断querySnapshot.docs.isEmpty时展示空状态提示

内容的提问来源于stack exchange，提问作者Kisah Tegar Putra Abdi