Flutter集成Firestore报'receiver can be null'错误求助

看了Google的Firestore教程，在Flutter项目中集成时碰到空异常问题，已经导入相关包但无法解决，以下是相关代码及错误信息：

主页面代码 #

StreamBuilder(
  stream: FirebaseFirestore.instance.collection("testCity").snapshots(),
  builder: (context, snapshot) {
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const Text("Bitte Warten");
    }

    return ListView.separated(
      padding: const EdgeInsets.fromLTRB(24, 16, 24, 24),
      physics: const NeverScrollableScrollPhysics(),
      shrinkWrap: true,
      itemCount: snapshot.data.docs.length,
      itemBuilder: (context, int index) {
        return NormalCard(database: snapshot.data.docs[index]);
      },
      separatorBuilder: (BuildContext context, int index)
      => const Divider(
        height: 32,
        thickness: 4,
        color: Color(0xFF484848),
      ),
    );
  },
)

NormalCard组件代码 #

class NormalCard extends StatefulWidget {
  const NormalCard({Key? key, required this.database}) : super(key: key);

  final DocumentSnapshot database;

  @override
  State<NormalCard> createState() => _NormalCardState();
}

class _NormalCardState extends State<NormalCard> {
  @override
  Widget build(BuildContext context) {
    DocumentSnapshot database = widget.database;
    return LayoutBuilder(
      ...
    );
  }
}

错误信息 #

问题面板提示："The property 'docs' can't be unconditionally accessed because the receiver can be 'null'."

运行时错误：

lib/Pages/page_startseite.dart:80:40: Error: Property 'docs' cannot be accessed on 'QuerySnapshot<Map<String, dynamic>>?' because it is potentially null.
- 'QuerySnapshot' is from 'package:cloud_firestore/cloud_firestore.dart' ('../../../AppData/Local/Pub/Cache/hosted/pub.dev/cloud_firestore-4.14.0/lib/cloud_firestore.dart').
- 'Map' is from 'dart:core'.
Try accessing using ?. instead.
itemCount: snapshot.data.docs.length,
^^^^
lib/Pages/page_startseite.dart:82:59: Error: Property 'docs' cannot be accessed on 'QuerySnapshot<Map<String, dynamic>>?' because it is potentially null.
- 'QuerySnapshot' is from 'package:cloud_firestore/cloud_firestore.dart' ('../../../AppData/Local/Pub/Cache/hosted/pub.dev/cloud_firestore-4.14.0/lib/cloud_firestore.dart').
- 'Map' is from 'dart:core'.
Try accessing using ?. instead.
return NormalCard(database: snapshot.data.docs[index]);
^^^^
lib/Pages/page_exploreseite.dart:112:40: Error: Required named parameter 'database' must be provided.
return const NormalCard();
^
lib/Widgets/card_restaurantNormal.dart:5:9: Context: Found this candidate, but the arguments don't match.
const NormalCard({Key? key, required this.database}) : super(key: key);
^^^^^^^^^^

尝试添加?会导致代码中断，添加!也无效果，希望解决问题以将Firestore作为项目后端。

1. 处理StreamSnapshot的空数据问题 #

Dart空安全要求必须明确处理null情况，snapshot.data可能为null（比如查询无结果、网络错误），不能直接无条件访问docs。修改主页面的StreamBuilder代码：

StreamBuilder<QuerySnapshot<Map<String, dynamic>>>(
  stream: FirebaseFirestore.instance.collection("testCity").snapshots(),
  builder: (context, snapshot) {
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const Text("Bitte Warten");
    }

    // 处理无数据或数据为null的情况
    if (!snapshot.hasData || snapshot.data!.docs.isEmpty) {
      return const Text("暂无数据");
    }

    // 明确获取非null的QuerySnapshot
    final querySnapshot = snapshot.data!;

    return ListView.separated(
      padding: const EdgeInsets.fromLTRB(24, 16, 24, 24),
      physics: const NeverScrollableScrollPhysics(),
      shrinkWrap: true,
      itemCount: querySnapshot.docs.length,
      itemBuilder: (context, int index) {
        return NormalCard(database: querySnapshot.docs[index]);
      },
      separatorBuilder: (BuildContext context, int index)
      => const Divider(
        height: 32,
        thickness: 4,
        color: Color(0xFF484848),
      ),
    );
  },
)

• 给StreamBuilder指定泛型QuerySnapshot<Map<String, dynamic>>，避免类型模糊
• 添加!snapshot.hasData的判断，提前返回空状态UI
• 将snapshot.data!赋值给局部变量querySnapshot，后续直接使用该变量，避免重复写!

2. 修复NormalCard的类型匹配问题 #

修改NormalCard的参数类型，明确指定为DocumentSnapshot<Map<String, dynamic>>，和Firestore返回的类型一致：

class NormalCard extends StatefulWidget {
  const NormalCard({Key? key, required this.database}) : super(key: key);

  // 修改为明确的泛型类型
  final DocumentSnapshot<Map<String, dynamic>> database;

  @override
  State<NormalCard> createState() => _NormalCardState();
}

class _NormalCardState extends State<NormalCard> {
  @override
  Widget build(BuildContext context) {
    DocumentSnapshot<Map<String, dynamic>> database = widget.database;
    return LayoutBuilder(
      ...
    );
  }
}

3. 修复page_exploreseite.dart的参数缺失问题 #

在page_exploreseite.dart的第112行，NormalCard要求必填database参数，不能直接const NormalCard()，必须传入有效的DocumentSnapshot对象，示例：

// 根据页面逻辑传入正确的DocumentSnapshot对象
return NormalCard(database: targetDocumentSnapshot);

如果该页面不需要展示Firestore数据，可考虑返回其他UI组件替代，或修改NormalCard将database改为可选参数（不推荐，破坏组件设计逻辑）。

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