Firestore 查询错误：Expected type 'Query', but it was: a custom Object object 解析与避免

2024-03-06 13:47:18

Firestore 查询与错误修复

引言

Firebase Firestore 是一种功能强大的数据库服务，它可以帮助你轻松地管理和查询数据。然而，有时你会遇到错误，这可能会阻碍你的进度。本文将探讨一个常见的 Firestore 查询错误：FirebaseError: Expected type 'Query', but it was: a custom Object object。我们将探讨导致此错误的原因并提供解决方案。

错误

当你在 Firestore 中进行数据查询时，你可能会遇到以下错误：

FirebaseError: Expected type 'Query', but it was: a custom Object object

这个错误表明你尝试使用一个自定义对象作为 getDocs() 函数的参数，而该函数需要一个 Query 对象。

原因分析

此错误的原因是，getDocs() 函数需要一个 Query 对象作为参数。 Query 对象是由 query() 函数创建的，并用于定义要执行的查询。

解决方案

要解决此问题，你需要将 colRef 转换为一个查询对象。你可以使用 where()、orderBy() 等方法来创建查询。

以下是如何使用 where() 方法创建查询的示例：

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

// Create a query
const q = query(colRef, where("artist", "==", "Bob Dylan"));

// Get documents from the query
const snapshot = await getDocs(q);

// Loop through the documents
snapshot.forEach((doc) => {
  console.log(doc.id, "=>", doc.data());
});

验证连接

在排除查询错误之前，验证你的 Firebase 应用程序是否已正确连接到 Firestore 非常重要。你可以使用以下步骤进行验证：

打开 Firebase 控制台并转到 Firestore 选项卡。
如果你的应用程序已连接，你应该能够在控制台中看到你的数据库和集合。
在浏览器控制台中，你可以使用 db 常量来检查与 Firestore 的连接状态：

console.log(db);

如果输出显示 { ... }，则表明你的应用程序已成功连接到 Firestore。

注意要点

确保 firebaseConfig 对象包含正确的凭据。
getDocs() 函数返回一个异步快照对象。你需要使用 await 或 .then() 方法来处理快照。
使用 colRef 作为查询的第一个参数。
getDocs() 函数接受可变数量的查询对象作为参数。你可以连接多个查询来创建更复杂的查询。

结论

通过遵循本文中的步骤，你应该能够成功地使用 Firebase Firestore 查询数据。解决查询错误对于确保你的应用程序平稳运行至关重要。

常见问题解答

如何使用 orderBy() 方法进行排序？

你可以使用 orderBy() 方法对查询结果进行排序。以下是如何按名称对文档进行排序的示例：
```
const q = query(colRef, orderBy("name"));
```
如何连接多个查询？

你可以使用 where() 和 orderBy() 方法连接多个查询。例如，以下查询查找所有名称以 "B" 开头且年龄大于 30 的文档：
```
const q = query(colRef, where("name", "startsWith", "B"), where("age", ">", 30));
```
如何获取所有文档？

要获取所有文档，你可以创建一个没有过滤条件的查询。以下查询获取集合中的所有文档：
```
const q = query(colRef);
```
如何限制查询结果？

你可以使用 limit() 方法限制查询结果的数量。以下查询限制结果为 10 个文档：
```
const q = query(colRef, limit(10));
```
如何获取查询快照的文档？

要获取查询快照的文档，你可以使用 getDocs() 函数。以下是如何获取文档的示例：
```
const snapshot = await getDocs(q);
snapshot.forEach((doc) => {
  console.log(doc.id, "=>", doc.data());
});
```