Flutter疑难：为何我的Firestore查询函数返回值永远不可能为null？

• 异步调用未加await：getFriendDocID是异步函数，返回的是Future<String?>类型。你直接把它赋值给friendRecordExists时，这个变量的实际类型是Future实例，而非你期望的String?。Future对象本身永远不会为null，所以编译器会提示你的判断条件永远为false。
• 函数内部写法冗余：已经用limit(1)限制了查询结果最多1条，没必要用forEach遍历，直接取第一个文档的ID更高效。

1. 修复调用处的异步获取逻辑 #

必须在异步函数上下文中使用await获取实际返回值：

// 注意：这段代码必须放在标记了async的函数内部
final friendRecordExists = await getFriendDocID(friendUsername);

if (friendRecordExists == null) {
  // 处理未找到好友记录的逻辑
}

2. 优化函数内部实现 #

简化取ID的逻辑，同时给变量加上明确类型，提升代码可读性：

Future<String?> getFriendDocID(String friendUsername) async {
  final firestore = FirebaseFirestore.instance;
  final friendQuerySnapshot = await firestore
      .collection(usersCollection)
      .doc(currentUID)
      .collection(friendsCollection)
      .where('username', isEqualTo: friendUsername)
      .limit(1)
      .get();

  if (friendQuerySnapshot.docs.isEmpty) {
    return null;
  }

  // 直接取第一个文档的ID（因limit(1)最多返回1条）
  return friendQuerySnapshot.docs.first.id;
}

• Dart中异步函数的返回值是Future容器，必须通过await（async函数内）或.then()链式调用，才能取出容器里的实际数据。
• 使用docs.isEmpty代替size == 0是更符合Dart风格的写法，可读性更强。

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