使用FutureBuilder包裹整个Scaffold时出现非空类型错误求助

你这个错误的核心原因是build方法没有返回FutureBuilder组件，原代码里只声明了FutureBuilder但没写return，导致Dart判定build函数可能返回null，触发非空类型报错。另外，虽然你硬编码了Scaffold，但FutureBuilder的builder逻辑最好覆盖所有状态分支，避免潜在的null返回问题。

修正后的完整代码 #

@override
Widget build(BuildContext context) {
  routeData = ModalRoute.of(context)?.settings.arguments as Map;
  print(routeData);

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

  // 关键：必须return这个FutureBuilder，让build方法返回Widget
  return FutureBuilder<DocumentSnapshot>(
    future: docRef.get(),
    builder: (context, snapshot) {
      // 加载中状态
      if (snapshot.connectionState == ConnectionState.waiting) {
        return Scaffold(
          appBar: AppBar(title: Text("Waiting...")),
          body: const Center(child: CircularProgressIndicator()),
        );
      }
      // 加载出错状态
      if (snapshot.hasError) {
        return Scaffold(
          appBar: AppBar(title: Text("加载出错")),
          body: Center(child: Text("错误信息: ${snapshot.error}")),
        );
      }
      // 数据加载完成状态
      if (snapshot.hasData && snapshot.data != null) {
        final docData = snapshot.data!.data() as Map<String, dynamic>;
        return Scaffold(
          appBar: AppBar(title: Text(docData['title'] ?? "详情页")),
          body: Padding(
            padding: const EdgeInsets.all(16),
            child: Text(docData['content'] ?? "暂无内容"),
          ),
        );
      }
      // 兜底状态，确保任何情况都返回Widget
      return Scaffold(
        appBar: AppBar(title: Text("状态异常")),
        body: const Center(child: Text("无法获取数据")),
      );
    },
  );
}

核心修复点 #

• 给FutureBuilder加上return，让build方法明确返回这个组件，解决最根本的null返回问题。
• 完善builder的状态分支：覆盖加载中、出错、数据完成、兜底四种情况，确保每个分支都返回Scaffold，彻底避免非空报错。
• 增加了数据非空判断，避免直接访问snapshot.data时可能出现的空指针问题。

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