Firestore实体大小限制相关疑问及规避方案咨询

一、这里的“实体”具体指什么？ #

在Firestore里，这个“实体”其实就是单个文档（Document）——不管这个文档里有没有嵌套集合，只要是你写入/更新的那个顶级文档，它的总大小不能超过1,048,572字节（约1MB）。
你提到触发错误的是“项目”，如果你的“项目”对应的是Firestore里的单个文档，那完全匹配这个限制场景。需要明确：文档里的所有字段（包括嵌套对象、数组、字符串、数字等）都会被计入大小，但文档里嵌套的集合本身不会占用该文档的存储空间——集合只是文档的一个“引用入口”，集合内的实际数据是单独存储的。

二、如何避免文档大小超限问题？ #

结合Firestore的设计逻辑，推荐几种实用的解决方案：

• 拆分大文档：把一个过大的文档拆分成多个关联的小文档。比如原本在用户文档里存所有订单记录，现在可以把订单单独放在users/{userId}/orders集合中，每个订单作为独立文档，通过用户ID关联。
• 用子集合存储批量数据：如果有评论、日志这类数组形式的大量重复数据，别把它们塞进主文档的数组里，而是创建对应的子集合，每条数据作为子集合里的单个文档。
• 压缩大字段内容：如果有大文本、长JSON字符串这类内容，可以先做压缩（比如gzip）再存储，读取时再解压。不过要注意，压缩后的内容仍需在限制内，且会增加读写时的处理成本。
• 大文件转存云存储：如果是图片、视频、大型二进制文件，不要直接存在Firestore文档里，上传到Cloud Storage后，把文件的存储路径或下载URL存在Firestore文档中即可。

举个调整结构的例子：
原本超限的文档结构：

{
  "userId": "123",
  "name": "John",
  "orders": [
    {"id": "order1", "amount": 100, ...},
    {"id": "order2", "amount": 200, ...},
    // 数百条订单导致文档过大
  ]
}

优化后：

• 主文档users/123仅存基础信息：{"userId": "123", "name": "John"}
• 创建子集合users/123/orders，每个订单作为独立文档：orders/order1、orders/order2...

这样既规避了大小限制，也更符合Firestore的查询优化设计，查询特定订单时效率更高。

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