Firestore查询求助：如何获取含名为John用户引用的Families集合文档

我明白你遇到的问题——当users字段存储的是Firestore文档引用时查询返回空，但改成字符串就正常，这其实是因为Firestore对引用类型的查询有特定要求，咱们一步步解决：

核心原因 #

Firestore的DocumentReference是强类型，你不能用字符串ID直接匹配引用字段，必须用对应的DocumentReference对象来进行查询；另外，查询方式还要看你users字段的具体结构。

步骤1：先获取目标用户的DocumentReference #

首先你得拿到名为'john'的用户对应的文档引用，以JavaScript为例：

import { getFirestore, doc } from "firebase/firestore";

const db = getFirestore();
// 假设john的文档ID是'john'，且Users集合是根集合
const johnUserRef = doc(db, "Users", "john");

⚠️ 注意：必须确保集合路径和文档ID完全正确（比如大小写、是否是子集合），路径错了引用不匹配，自然查不到结果。

步骤2：根据users的结构选择查询方式 #

你的users字段是存储引用的对象，这里分两种常见情况：

情况A：users是引用数组

如果你的结构是这样的：

{
  users: [johnUserRef, ...其他用户引用]
}

那用array-contains查询即可，这是最推荐的结构，因为查询灵活：

import { collection, query, where, getDocs } from "firebase/firestore";

const q = query(
  collection(db, "Families"),
  where("users", "array-contains", johnUserRef)
);

const querySnapshot = await getDocs(q);
querySnapshot.forEach((doc) => {
  console.log("匹配的家庭文档：", doc.id, doc.data());
});

情况B：users是键值对对象（键为用户ID，值为引用）

如果你的结构是这样的：

{
  users: {
    "john": johnUserRef,
    "jane": janeUserRef
  }
}

那你需要指定具体的键来查询：

const q = query(
  collection(db, "Families"),
  where("users.john", "==", johnUserRef)
);

// 后续获取结果的逻辑同上

⚠️ 这种方式的局限：如果不知道用户的ID，或者想查询所有包含该引用的文档（不管键名），这种结构就不适用了，建议改成数组结构更灵活。

为什么之前用字符串能查到？ #

当你把引用换成用户ID字符串时，相当于把强类型的引用变成了普通字符串，这时候你可能用了array-contains匹配字符串，或者where("users.john", "exists", true)这类查询，自然能匹配到；但用引用时，必须严格用DocumentReference对象来匹配，字符串和引用是完全不同的类型，Firestore不会自动转换匹配。

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