如何在Flutter initState中处理Future，解决Firebase数据加载空类型报错

• 调用getUserById时，若传入的uid对应的Firestore用户文档不存在，doc.data()会返回null，直接强制转换为Map<String, dynamic>就会抛出Null is not a sub type of Map<String, dynamic>错误
• UserModel.fromJson方法内部对入参data使用了!强制非空解包，若入参为null也会触发同类空类型错误
• initState中直接打印isAdmin默认是空值，因为checkForAdmin是异步方法，打印执行时异步请求还未完成，isAdmin还没有被赋值

1. 优化CRUD查询方法，增加空判断 #

先校验文档是否存在、返回数据是否为空，避免强转空值报错：

Future<UserModel> getUserById({String? id}) async {
  var doc = await _api!.getUserById(id: id);
  // 先判断文档存在且数据非空再做转换
  if (doc.exists && doc.data() != null) {
    return UserModel.fromJson(doc.data() as Map<String, dynamic>);
  }
  // 文档不存在时返回默认用户对象，避免空异常
  return UserModel(isAdmin: false);
}

2. 修复UserModel.fromJson的空安全逻辑 #

去除强制非空解包，空值直接走默认值填充：

UserModel.fromJson(Map<String?, dynamic>? data) {
  id = data?['id'] ?? '';
  displayName = data?['displayName'] ?? '';
  email = data?['email'] ?? '';
  phoneNumber = data?['phoneNumber'] ?? '';
  photoUrl = data?['photoUrl'] ?? '';
  isAdmin = data?['isAdmin'] ?? false;
  deviceToken = data?['deviceToken'] ?? "";
}

3. 优化异步逻辑处理 #

所有依赖isAdmin的业务逻辑必须放在异步执行完成的代码块中，同时可以加加载状态控制页面渲染，避免空值异常：

// 新增加载状态变量
bool _isLoadingAdmin = true;

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

Future<bool?> checkForAdmin() async {
  var crud = Provider.of<CRUDModel>(context, listen: false);
  var data = await crud.getUserById(id: widget.user!.uid);
  setState(() {
    isAdmin = data.isAdmin;
    _isLoadingAdmin = false; // 标记加载完成
  });
  // 所有依赖isAdmin的业务逻辑写在这里
  if(isAdmin == true) {
    // 执行管理员专属逻辑，比如显示管理入口、权限跳转等
  }
  return data.isAdmin;
}

// build时先判断加载状态，避免空值导致页面渲染异常
@override
Widget build(BuildContext context) {
  if(_isLoadingAdmin) {
    return const Center(child: CircularProgressIndicator());
  }
  // 原有页面渲染逻辑
  return ...;
}

额外优化建议 #

你当前写的UserModel.fromFirestoreQuerySnapshot方法无返回值、遍历结果也没有被接收，属于无效逻辑，若需要从查询快照生成用户列表可以改成如下实现：

static List<UserModel> fromFirestoreQuerySnapshot(QuerySnapshot snapshot) {
  return snapshot.docs.map((doc) {
    final data = doc.data() as Map<String, dynamic>;
    return UserModel.fromJson(data);
  }).toList();
}

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