Flutter页面跳转报错：NoSuchMethodError getter 'data'被调用在null上

错误根源 #

你遇到的NoSuchMethodError是因为在ItemDetails组件中，提前声明了未初始化的var snapshot;，随后直接尝试访问snapshot.data!.data()——这个snapshot是null，触发了空值调用错误。此外还有几处细节问题需要修正：

具体修正步骤 #

• 移除无效的变量与数据读取：删除var snapshot;和final data = snapshot.data!.data() as Map<String, dynamic>;这两行，数据读取必须放在FutureBuilder的builder回调内部。
• 安全处理路由参数：获取路由参数时避免强制类型转换引发空指针，改用空安全的兜底处理。
• 修正语法错误：将collection(“table_name”)中的中文引号改为英文引号'table_name'。
• 在FutureBuilder内部读取文档数据：通过builder回调传入的snapshot获取Firestore返回的文档数据。

修正后的ItemDetails代码 #

class ItemDetails extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // 安全获取路由参数，为空时返回空Map兜底
    final routeData = ModalRoute.of(context)?.settings.arguments as Map? ?? {};
    print(routeData);

    final DocumentReference docRef =
        FirebaseFirestore.instance.collection('table_name').doc(routeData['id']);

    return FutureBuilder<DocumentSnapshot>(
      future: docRef.get(),
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
          return Scaffold(
            appBar: AppBar(
              title: Text("加载中..."),
            ),
            body: const Center(child: CircularProgressIndicator()),
          );
        } else if (snapshot.hasError) {
          return Scaffold(
            appBar: AppBar(
              title: const Text("错误"),
            ),
            body: Center(child: Text("错误: ${snapshot.error}")),
          );
        } else if (!snapshot.hasData || !snapshot.data!.exists) {
          // 新增文档不存在的异常处理
          return Scaffold(
            appBar: AppBar(
              title: const Text("未找到数据"),
            ),
            body: const Center(child: Text("该记录不存在")),
          );
        } else {
          // 从builder的snapshot中读取有效数据
          final data = snapshot.data!.data() as Map<String, dynamic>;
          return Scaffold(
            appBar: AppBar(
              title: Text(data["name"] ?? "详情"),
            ),
            body: const Center(child: Text("数据已加载")),
          );
        }
      },
    );
  }
}

额外优化建议 #

• 在ItemList的StreamBuilder中指定泛型类型，避免隐式类型转换：

  builder: (BuildContext context, AsyncSnapshot<QuerySnapshot> snapshot) {
  

• 对items转换时的字段添加空值兜底，比如e['name'] ?? '未知名称'，避免因Firestore文档字段缺失导致的错误。

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