Firestore array-contains查询嵌套对象数组无结果问题排查

Firestore的array-contains查询对象数组时，要求查询的对象与数组中存储的对象完全匹配——包括所有字段名、字段值（类型和内容），不能多字段也不能少字段，哪怕是细微的差异都会导致匹配失败。你的查询无结果，大概率是以下原因之一：

可能的错误点 #

• 查询的对象缺少数据库中存储的字段：比如数据库里的funcionarios对象包含uid字段，但你只传了photoURL和value，导致无法匹配。
• 值存在细微差异：比如photoURL末尾有空格、大小写不一致，或是displayName的拼写与数据库中存储的不完全相同（比如数据库是"ricardo meireles"，而currentUser.displayName是"Ricardo Meireles"）。
• 字段名大小写不匹配：比如数据库里的字段是photoUrl（小写u），但你代码里写的是photoURL（大写U）。

解决方法 #

方法1：确保查询对象与存储对象完全一致 #

去Firebase控制台打开任意一个包含目标用户的tarefas文档，复制funcionarios数组中该用户的完整对象，用这个完整对象作为array-contains的查询值。比如如果控制台里的对象是：

{
  uid: "abc123",
  photoURL: "https://example.com/photo.jpg",
  value: "Ricardo Meireles"
}

那查询代码要改成：

where("funcionarios", "array-contains", {
  uid: currentUser.uid,
  photoURL: currentUser.photoURL,
  value: currentUser.displayName,
})

方法2：改用唯一标识简化查询（推荐） #

如果只需要按用户身份匹配，建议把funcionarios字段改成存储用户uid的数组（而非对象数组），这样查询更稳定且性能更好：

// 存储时只存uid：funcionarios: ["abc123", "def456"]
// 查询代码改成：
const q = query(
  collection(db, "tarefas"),
  where("funcionarios", "array-contains", currentUser.uid)
);

后续需要显示用户信息时，再通过uid关联用户数据即可。

方法3：检查值的一致性 #

对比currentUser的photoURL和displayName与数据库中存储的值，确保没有大小写、空格或格式差异。比如可以在控制台直接用数据库中存储的value值做测试查询，看是否能返回结果。

内容的提问来源于stack exchange，提问作者João Silva