Streambuilder查询Firestore时是获取完整文档还是仅加载所需字段？

核心结论 #

StreamBuilder本身仅负责监听数据流并构建UI，不参与Firestore的数据拉取逻辑，你当前的实现会拉取完整文档内容，不会仅加载代码中用到的字段。

具体原理 #

Firestore的集合查询默认粒度为完整文档：你调用planCol.snapshots()时，服务端会把符合查询条件的所有文档的全部字段都返回给客户端，哪怕你业务代码里只用到name字段，文档中存储的exerciseNames、rows等大体积字段也会被全量下载。
当单文档体积较大、文档数量较多时，会额外消耗用户流量、增加数据加载耗时，进而降低页面加载效率。

优化方案 #

如果仅需要用到部分字段，可以使用Firestore提供的select()方法做字段投影，让服务端仅返回你指定的字段，大幅减少传输的数据量：

// 优化后的流，仅拉取每个文档的name字段
stream: planCol.select(['name']).snapshots(),

注意事项 #

如果使用select()做字段投影，查询返回的文档快照仅包含你指定的字段，你当前代码中点击列表跳转到ExerciseTable页时，直接从列表文档快照中取exerciseNames、rows字段的逻辑会报错。这种场景有两种适配方案：

• 列表页保持用select()优化，跳转时仅传递文档ID，到ExerciseTable页再单独查询对应文档的完整数据
• 如果文档总数量不多、大字段体积未到影响加载体验的程度，也可以保留全量拉取的逻辑，根据实际业务场景取舍即可。

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