如何用Firebase Node.js Admin SDK分页获取Firestore含已删除文档的列表？

问题核心 #

你提到的Node.js Admin SDK的listDocuments()方法确实不支持limit()或分页参数，这是当前SDK实现的局限，并非你的理解错误。Firestore的REST API底层支持分页（pageSize和pageToken），但SDK暂未封装该能力。

可行解决方案 #

方案1：直接调用Firestore REST API #

既然REST API原生支持分页和返回已删除文档，你可以在Node.js中直接通过HTTP客户端调用该接口，配合Admin SDK的认证机制实现权限验证。

示例代码

首先安装依赖：

npm install axios google-auth-library

然后编写分页获取逻辑：

const { GoogleAuth } = require('google-auth-library');
const axios = require('axios');

// 初始化认证客户端，使用Admin SDK的默认凭据
const auth = new GoogleAuth({
  scopes: ['https://www.googleapis.com/auth/cloud-platform']
});

async function listDocumentsWithPagination(collectionPath, pageSize = 50, pageToken = null) {
  const projectId = process.env.GCLOUD_PROJECT || '你的项目ID';
  const databaseName = `projects/${projectId}/databases/(default)`;
  const url = `https://firestore.googleapis.com/v1/${databaseName}/documents/${collectionPath}:listDocuments`;

  const params = {
    pageSize,
    showMissing: true, // 关键：返回已删除的文档（只要未被彻底清理）
  };
  if (pageToken) {
    params.pageToken = pageToken;
  }

  const client = await auth.getClient();
  const accessToken = await client.getAccessToken();
  const headers = {
    'Authorization': `Bearer ${accessToken.token}`
  };

  const response = await axios.get(url, { params, headers });
  return {
    documents: response.data.documents,
    nextPageToken: response.data.nextPageToken
  };
}

// 使用示例：循环获取所有分页数据
async function fetchAllPages() {
  let nextPageToken = null;
  do {
    const result = await listDocumentsWithPagination('你的集合路径', 50, nextPageToken);
    console.log('当前页文档:', result.documents);
    nextPageToken = result.nextPageToken;
  } while (nextPageToken);
}

fetchAllPages().catch(console.error);

方案2：基于文档ID范围模拟分页（局限性较强） #

如果你的文档ID有可排序的规律（比如带时间戳前缀），可以手动划分ID范围，多次调用listDocuments()并通过startAt()和endAt()模拟分页。但这种方法依赖ID规则，无法精准控制每页数量，仅作为备选方案。

关于读取次数 #

直接调用REST API的分页方式，每次请求仅读取pageSize数量的文档元数据，符合最小化读取次数的需求（Firestore按文档元数据读取次数计费，和SDK调用规则一致）。

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