Flutter从Firestore取数据时触发‘空值检查运算符用在空值上’异常

问题根源分析 #

你遇到的Null check operator used on a null value异常，主要来自两个方面：

1. 代码中滥用了强制非空运算符!，当SharedPreference().getCred('email')或getUser返回null时，直接触发异常。
2. UserModel的getUser函数存在变量重名问题，导致取值逻辑完全错误，同时缺少文档存在性判断。

修复代码 #

1. 修改getData函数，移除强制非空，处理null场景

Future<void> getData() async {
  emailFromPrefs = await SharedPreference().getCred('email');
  // 先检查本地存储的邮箱是否为空，为空则提前处理（比如跳转登录）
  if (emailFromPrefs == null) {
    return;
  }
  nameFromDatabase = await UserModel().getUser(emailFromPrefs, 'name');

  setState(() {
    name = nameFromDatabase ?? '未知用户';
    email = emailFromPrefs;
  });
}

2. 修复UserModel的getUser函数

Future<String?> getUser(String email, String fieldName) async {
  try {
    CollectionReference users = FirebaseFirestore.instance.collection('users');
    final snapshot = await users.doc(email).get();
    
    // 先判断文档是否存在
    if (!snapshot.exists) {
      return '用户不存在';
    }
    
    final userData = snapshot.data() as Map<String, dynamic>;
    // 使用传入的字段名取值，同时处理字段为空的情况
    return userData[fieldName]?.toString() ?? '未设置';
  } catch (e) {
    return '获取用户信息失败: $e';
  }
}

关键修改说明 #

• 移除所有不必要的!运算符：强制非空会忽略null风险，改用空值判断和默认值替代。
• 修复变量重名：将原getUser的参数data改为fieldName，避免和局部变量userData混淆，确保正确读取指定字段。
• 增加文档存在性检查：避免因文档不存在导致snapshot.data()返回null后强制转换报错。
• 错误信息具体化：捕获异常时带上具体错误内容，方便后续调试。

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