如何查询Firestore中文档的实际占用大小？

Firestore 本身没有提供直接返回文档存储大小的API，但可以通过以下两种方式快速获取精确值或近似值：

方法1：按官方规则计算精确值 #

Firestore 公开了文档大小的统一计算规则，你可以自行封装工具函数实现计算：

单文档总大小 = 完整文档路径字节数 + 所有字段名字节数之和 + 所有字段值字节数之和 + 32字节固定额外开销
各部分的计算规则如下：

• 文档路径：完整路径字符串的UTF-8编码字节数，比如projects/你的项目ID/databases/(default)/documents/集合名/文档ID的长度
• 字段名：每个字段名的UTF-8编码字节数之和
• 字段值按类型计算：
  • 字符串、二进制类型：实际内容字节数 + 1字节
  • 布尔值：1字节
  • 整数、浮点数、时间戳：8字节
  • 地理位置坐标：16字节
  • 数组：数组内所有元素大小之和 + 1字节
  • 嵌套映射：映射内所有键值对的大小之和

以下是Node.js环境的示例实现片段：

// 计算单个值的大小
function getValueSize(value) {
  if (typeof value === 'string') return Buffer.from(value).length + 1;
  if (typeof value === 'boolean') return 1;
  if (typeof value === 'number') return 8;
  if (value instanceof Date || value.constructor.name === 'Timestamp') return 8;
  if (Array.isArray(value)) return value.reduce((sum, item) => sum + getValueSize(item), 0) + 1;
  if (typeof value === 'object' && value !== null) {
    return Object.entries(value).reduce((sum, [k, v]) => {
      return sum + Buffer.from(k).length + getValueSize(v);
    }, 0);
  }
  // 其他类型可参照官方规则补充
  return 0;
}

// 计算完整文档大小，单位字节
function calcDocTotalSize(docRef, docData) {
  let total = Buffer.from(docRef.path).length;
  for (const [field, val] of Object.entries(docData)) {
    total += Buffer.from(field).length + getValueSize(val);
  }
  total += 32;
  return total;
}

// 调用示例
const docRef = db.collection('users').doc('user1');
const doc = await docRef.get();
const sizeInBytes = calcDocTotalSize(docRef, doc.data());
const sizeInMiB = sizeInBytes / (1024 * 1024);

方法2：导出文档快速估算 #

如果不需要精确值，只是快速判断是否接近1MiB阈值，可以用Firebase CLI导出文档估算：

• 执行导出命令：firebase firestore:documents:get 你的集合名/你的文档ID > temp_doc.json
• 导出的JSON文件大小乘以1.3，就是文档在Firestore中实际存储的近似大小，误差通常在10%以内，足够快速排查超限风险。

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