无大文档却抛出BsonMaximumSizeExceededException问题排查

你遇到的BsonMaximumSizeExceededException不是因为返回的结果文档过大，而是传入Filters.in的ids集合元素数量太多，导致生成的查询条件Bson文档本身超过了MongoDB的单Bson文档大小限制（16MB）。

MongoDB的$in操作符会把你传入的所有id打包成一个Bson数组，当ids的数量足够多（比如几十上百万个字符串id），这个查询条件的Bson体积就会突破16MB上限，直接触发异常。

1. 分批查询（最直接有效的方案） #

把大的ids集合拆分成多个小批次，每个批次的id数量控制在不会让查询Bson超标的范围（比如每次取1000-5000个id，具体数值可根据id字符串长度调整：短id可以多取，长id适当少取），逐个批次执行in查询后合并所有结果。

示例代码：

MongoDatabase db = client.getDatabase(DB_NAME);
MongoCollection<Document> occurrences = db.getCollection(WORD_COUNT);
List<Document> allDocs = new ArrayList<>();

// 分批大小，根据实际情况调整
int batchSize = 1000;
List<String> idBatch = new ArrayList<>(batchSize);

for (String id : ids) {
    idBatch.add(id);
    if (idBatch.size() == batchSize) {
        // 执行当前批次查询
        allDocs.addAll(occurrences.find(in("_id", idBatch)).into(new ArrayList<>()));
        idBatch.clear();
    }
}
// 处理剩余未达批次大小的id
if (!idBatch.isEmpty()) {
    allDocs.addAll(occurrences.find(in("_id", idBatch)).into(new ArrayList<>()));
}

// 转换为目标数组（如果需要）
Document[] docs = allDocs.toArray(new Document[0]);

2. 确认_id字段的索引有效性 #

MongoDB默认会给_id字段创建唯一索引，但最好手动确认索引存在。分批查询依赖索引保证性能，没有索引的话，分批查询的速度会大幅下降。

3. 可选：超大规模id集合的替代方案 #

如果你的ids数量达到百万级以上，可以考虑将这些ids存入临时集合，再通过$lookup聚合操作关联查询目标集合。不过这种方案复杂度较高，一般场景下分批查询足够解决问题。

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