如何在MongoDB Java驱动中实现无FETCH阶段的高效文档计数

要实现和mongosh中仅走IXSCAN阶段的高效计数，核心是利用覆盖索引，让查询完全通过索引完成计数，避免触发FETCH阶段读取完整文档。以下是具体实现步骤和代码示例：

关键前提 #

确保你的过滤条件完全匹配已有的索引（或索引前缀），且索引包含所有过滤字段。比如你提到的origin字段已建单键索引{origin: 1}，过滤条件需基于origin或其他已加入索引的字段。

Java驱动实现代码 #

使用find()配合投影仅保留索引字段并排除_id，再调用count()方法，示例如下：

import com.mongodb.client.MongoCollection;
import org.bson.Document;
import org.bson.conversions.Bson;
import static com.mongodb.client.model.Filters.eq;
import static com.mongodb.client.model.Projections.*;

// 获取集合实例
MongoCollection<Document> collection = mongoDatabase.getCollection("your_collection");

// 构建过滤条件（示例：匹配origin字段值）
Bson filter = eq("origin", "target_value");

// 投影仅保留索引字段（origin），排除默认返回的_id（_id不在索引中会触发FETCH）
Bson projection = fields(
    include("origin"),
    excludeId()
);

// 执行高效计数，仅走IXSCAN阶段
long count = collection.find(filter)
    .projection(projection)
    .count();

为什么这种写法有效 #

• find().projection(...)指定只返回索引包含的字段，MongoDB无需从磁盘读取完整文档，直接从索引中提取数据完成计数，避免了FETCH阶段。
• 排除_id是关键：默认情况下find()会返回_id字段，若_id不在当前使用的索引中，MongoDB会触发FETCH以获取_id，因此必须显式排除。

额外注意事项 #

1. 复合索引适配多条件过滤：如果过滤条件包含多个字段，需要创建包含所有过滤字段的复合索引（如{origin:1, type:1}），同时投影仅保留这些索引字段，才能继续保持仅走IXSCAN的性能。
2. 避免使用countDocuments()：countDocuments()底层会执行包含$match和$group的聚合，默认会进行文档存在性验证，必然触发FETCH，性能远低于覆盖索引计数。
3. 验证执行计划：可以通过explain()确认是否仅触发IXSCAN：

import com.mongodb.client.model.Explain;

Explain explainResult = collection.find(filter)
    .projection(projection)
    .explain();
System.out.println(explainResult.toJson());

查看输出中的executionStages，确认只有IXSCAN阶段，无FETCH阶段即为成功。

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