如何解决Flutter中LateInitializationError: Field 'userMap' has not been initialized报错

错误原因 #

你用late修饰了userMap，说明该变量是不可空类型，且会在使用前完成初始化，因此Dart不会对late修饰的非空变量做null检查，即使你写了userMap != null的判断，只要在访问时该变量还没被赋值，就会直接抛出LateInitializationError。

解决方法 #

• 第一步：修改userMap的声明，去掉late关键字，改为可空类型

// 原声明：late Map<String,dynamic> userMap;
// 修改后：
Map<String,dynamic>? userMap;

• 第二步：优化搜索逻辑，增加查询结果为空的兼容处理，避免索引越界错误

void onSearch() async{
  FirebaseFirestore _firestore = FirebaseFirestore.instance;
  setState(() {
    isLoading = true;
    userMap = null; // 新搜索发起时清空旧结果
  });
  final value = await _firestore.collection('users').where('email', isEqualTo: _search.text).get();
  setState(() {
    if(value.docs.isNotEmpty){
      userMap = value.docs[0].data();
    }
    isLoading = false;
  });
  print(userMap);
}

• 第三步：调整布局判断逻辑，已判空的变量可使用!强制拆包调用

// 加载状态优先展示加载指示器，再判断用户数据是否存在
isLoading 
  ? const CircularProgressIndicator()
  : userMap != null 
    ? ListTile(
        title: Text(userMap!['name']),
        subtitle: Text(userMap!['email']),
      )
    : const SizedBox.shrink();

内容的提问来源于stack exchange，提问作者Coding-Jutsu