Mongo聚合命令转Java执行报错：$or/$and/$nor条目需为完整对象

问题场景 #

有一段在Mongo Shell中可正常运行的聚合查询：

db.tissue_source.aggregate([{
  $match:{
    "tissue_backups.23c5bd57da4e461caae0bbf2b06997b8": {
      $all: [{
          $elemMatch: {
            "63173253349670": {
              $regex: ".*?正常.*"
            }
          }
        }, {
          $elemMatch: {
            "63173253349670": {
              $regex: ".*?出库.*"
            }
          }
        }
      ]
    }
  }
}])

转换为Java的BasicDBObject实现后执行，抛出如下异常：

com.mongodb.MongoCommandException: Command failed with error 2: '$or/$and/$nor entries need to be full objects' on server 127.0.0.1:27017. The full response is { "ok" : 0.0, "errmsg" : "$or/$and/$nor entries need to be full objects", "code" : 2, "codeName" : "BadValue" }

即使打印生成的BasicDBObject的JSON与原Shell命令一致，仍报此错误。

解决方案 #

核心原因 #

Java构造$all数组内的$elemMatch对象时，存在隐性类型错误：比如错误地将$elemMatch的条件直接作为数组元素，而非包裹在以$elemMatch为键的完整DBObject中；或是使用Java原生List而非MongoDB驱动提供的BasicDBList来构造数组，导致驱动无法正确识别为MongoDB数组对象。

正确的Java代码实现 #

import com.mongodb.BasicDBList;
import com.mongodb.BasicDBObject;
import com.mongodb.DBCollection;
import com.mongodb.DBCursor;
import com.mongodb.DBObject;
import java.util.List;

// 获取目标集合
DBCollection collection = mongoClient.getDB("你的数据库名").getCollection("tissue_source");

// 构造第一个$elemMatch匹配条件
DBObject elemMatchNormal = new BasicDBObject("$elemMatch",
    new BasicDBObject("63173253349670",
        new BasicDBObject("$regex", ".*?正常.*")
    )
);

// 构造第二个$elemMatch匹配条件
DBObject elemMatchOut = new BasicDBObject("$elemMatch",
    new BasicDBObject("63173253349670",
        new BasicDBObject("$regex", ".*?出库.*")
    )
);

// 用BasicDBList构造$all对应的数组
BasicDBList allConditions = new BasicDBList();
allConditions.add(elemMatchNormal);
allConditions.add(elemMatchOut);

// 构造$match阶段
DBObject matchStage = new BasicDBObject("$match",
    new BasicDBObject("tissue_backups.23c5bd57da4e461caae0bbf2b06997b8",
        new BasicDBObject("$all", allConditions)
    )
);

// 执行聚合查询
DBCursor resultCursor = collection.aggregate(List.of(matchStage));

关键注意事项 #

• 必须使用BasicDBList而非Java原生ArrayList来构造MongoDB数组类型，否则驱动无法正确解析数组结构。
• 每个$elemMatch必须是独立的BasicDBObject，键为$elemMatch，值为具体匹配条件，不能省略外层键直接传入条件内容。
• 所有嵌套条件都需通过BasicDBObject构造，避免隐性类型不匹配（即使JSON打印结果一致，底层类型差异仍会导致报错）。

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