Firebase单文档查询与更新异常：docID返回空值问题求助

核心问题点 #

1. 集合引用缺失：代码中注释掉了.collection('NumRestaurantPicked')，如果db直接是Firestore实例而非集合引用，查询会指向根级文档，自然查不到目标数据，导致forEach循环不执行。
2. 异步逻辑混用：同时使用await和.then()，容易导致代码执行顺序混乱，外层变量无法正确被赋值。
3. 未初始化局部变量：docID、numPicked、restaurantExist看起来是全局变量，容易被其他逻辑污染，且初始状态不明确（比如numPicked若为null会导致相加报错）。
4. 类型不匹配：更新时把totalPicked（int类型）转成字符串存入，但numPicked是数值类型，会导致后续读取和计算出错。
5. 并发风险：直接读取后加1再更新，高并发场景下可能出现计数不准确，应该用Firebase的原子更新操作。

修复后的代码 #

Future<bool> searchQuery({
  required String restaurantName,
  required String userID, // 明确类型为String
  required CollectionReference db, // 明确db是集合引用
}) async {
  // 初始化局部变量，避免全局状态污染
  String docID = '';
  int numPicked = 0;
  bool restaurantExist = false;
  const addOne = 1;

  try {
    // 执行查询：按用户ID和餐厅名称过滤
    final querySnapshot = await db
        .where('userId', isEqualTo: FirebaseAuth.instance.currentUser!.uid)
        .where('restaurantName', isEqualTo: restaurantName)
        .get();

    // 判断是否查询到结果
    if (querySnapshot.docs.isNotEmpty) {
      final doc = querySnapshot.docs.first; // 每个用户-餐厅应该唯一，直接取第一个
      docID = doc.id;
      numPicked = doc['numPicked'] as int; // 强制类型转换，确保是int
      restaurantExist = true;
    }
  } catch (ex) {
    print('查询出错: $ex');
  }

  if (restaurantExist) {
    try {
      // 原子更新（推荐，彻底避免并发计数错误）
      await db.doc(docID).update({
        'numPicked': FieldValue.increment(addOne),
      });
    } catch (ex) {
      print('更新出错: $ex');
    }
  }

  return restaurantExist;
}

额外注意事项 #

• 调用函数时，db必须传入正确的集合引用，比如：FirebaseFirestore.instance.collection('NumRestaurantPicked')
• 需在Firebase控制台给userId和restaurantName组合创建复合索引，否则查询会触发报错（控制台会自动给出创建索引的链接）
• 提前做登录状态判断，避免FirebaseAuth.instance.currentUser为null时出现空指针异常

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