Flutter类型转换报错：'Null'不是'Map<String, dynamic>'的子类型

• 你直接声明了AsyncSnapshot<DocumentSnapshot>? snapshot;但未赋值，它默认是null，后续snapshot?.data!.data()必然返回null，强制转换为Map<String, dynamic>就触发了类型转换错误。
• Firestore数据获取是异步操作，不能在initState里同步直接获取数据，必须用异步处理方式。

方法1：使用FutureBuilder绑定数据与UI渲染 #

这是Flutter处理异步数据渲染的标准方式，自动管理加载、错误、完成状态：

@override
Widget build(BuildContext context) {
  return FutureBuilder<DocumentSnapshot>(
    future: FirebaseFirestore.instance.collection('user').doc(widget.id).get(),
    builder: (context, snapshot) {
      if (snapshot.connectionState == ConnectionState.waiting) {
        return const CircularProgressIndicator(); // 加载中占位
      }
      if (snapshot.hasError) {
        return Text('加载失败: ${snapshot.error}'); // 错误提示
      }
      // 先判断数据是否存在，避免null转换
      if (!snapshot.hasData || snapshot.data!.data() == null) {
        return const Text('用户数据不存在');
      }
      Map<String, dynamic> data = snapshot.data!.data() as Map<String, dynamic>;
      // 替换为你的业务UI
      return Text('用户名: ${data['username']}');
    },
  );
}

方法2：在initState中通过异步函数手动获取数据 #

如果需要手动控制数据加载时机，可以用这种方式：

late Map<String, dynamic> userData;

@override
void initState() {
  super.initState();
  _fetchUserData();
}

Future<void> _fetchUserData() async {
  try {
    DocumentSnapshot doc = await FirebaseFirestore.instance.collection('user').doc(widget.id).get();
    setState(() {
      userData = doc.data() != null ? doc.data() as Map<String, dynamic> : {};
    });
  } catch (e) {
    print('获取用户数据失败: $e');
    // 可添加错误提示弹窗或页面
    setState(() {
      userData = {};
    });
  }
}

@override
Widget build(BuildContext context) {
  // 初始加载状态判断
  if (userData.isEmpty) {
    return const CircularProgressIndicator();
  }
  // 替换为你的业务UI
  return Text('用户名: ${userData['username']}');
}

• 禁止在未做空检查的情况下使用!强制拆包，这是引发null错误的常见原因。
• Firestore的data()方法可能返回null（比如目标文档不存在），必须先判断再转换类型。
• 异步操作不能在initState中同步执行，必须通过Future、Stream或异步函数处理。

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