MongoDB Java驱动从3.8.1升级到4.6.1后，原有聚合查询因误用$and作为独立管道阶段而触发“Unrecognized pipeline stage name: '$and'”错误；根本原因在于新版驱动严格遵循MongoDB服务器语法规范，禁止将逻辑操作符$and作为顶层聚合阶段使用。
mongodb java驱动从3.8.1升级到4.6.1后，原有聚合查询因误用`$and`作为独立管道阶段而触发“unrecognized pipeline stage name: '$and'”错误；根本原因在于新版驱动严格遵循mongodb服务器语法规范，禁止将逻辑操作符`$and`作为顶层聚合阶段使用。
MongoDB 4.6.1驱动对聚合管道（Aggregation Pipeline）的语法校验更加严格，与服务端行为保持一致。在旧版驱动（如3.8.1）中，部分不规范的写法（例如将$and误当作独立$match阶段添加）可能被静默兼容或忽略；但新版驱动会直接抛出Unrecognized pipeline stage name: '$and'异常，提示该名称并非合法的聚合阶段（如$match、$group、$sort等），而是仅支持在$match内部使用的查询操作符。
正确用法：$and必须嵌套在$match中
$and是MongoDB查询表达式中的逻辑操作符，不能单独作为聚合管道的一个阶段。它只能出现在$match阶段的查询文档内，用于组合多个条件。例如：
// ✅ 正确：$and 作为 $match 内部的查询操作符
Bson matchStage = Aggregates.match(
Filters.and(
Filters.eq("status", "active"),
Filters.gte("createdAt", LocalDate.now().minusDays(30))
)
);
pipeline.add(matchStage);
常见错误及修复方式
你遇到的问题源于代码中类似以下的误用：
// ❌ 错误：试图将 $and 直接作为独立阶段添加（驱动3.8.1可能容忍，4.6.1拒绝）
pipeline.add(Filters.and(...)); // 这会生成 { "$and": [...] } —— 非法管道阶段！
该写法实际构造了一个形如 { "$and": [...] } 的BSON文档，并被当作一个聚合阶段加入管道，而MongoDB服务端根本不识别$and为有效阶段名，因此报错。
✅ 正确修复方式是确保所有逻辑过滤都封装在$match阶段内，并使用Filters.and(...)生成合规的查询表达式：
// ✅ 推荐：显式构建 $match 阶段，再添加到 pipeline
Bson andFilter = Filters.and(
Filters.eq("category", "electronics"),
Filters.gt("price", 100),
Filters.lt("stock", 50)
);
// 使用 Aggregates.match() 包装，而非直接 add()
pipeline.add(Aggregates.match(andFilter));
若原逻辑是动态拼接多个条件并批量加入，应避免使用 pipeline.add(and...)，改用 pipeline.addAll(...) 配合已包装好的$match阶段列表：
// ✅ 安全批量添加多个 $match 阶段（如有需要）
List<bson> matchStages = Arrays.asList(
Aggregates.match(Filters.eq("type", "user")),
Aggregates.match(Filters.gt("lastLogin", Instant.now().minus(7, DAYS)))
);
pipeline.addAll(matchStages); // 注意：addAll 接收的是 Bson 列表，非原始 Filters</bson>
补充注意事项
- Spring Boot 2.7.10 + MongoDB Driver 4.6.1 兼容性良好，无需降级；但需同步检查spring-boot-starter-data-mongodb版本是否匹配（建议使用3.4.x或更高，对应MongoDB Java Driver 4.6+）。
- 所有聚合阶段必须是标准阶段名（如$match, $project, $lookup等），任何以$开头但非官方阶段的键名都会触发此错误。
- 开发时建议开启MongoDB日志输出（如设置logging.level.org.springframework.data.mongodb.core=DEBUG），可直观查看最终发送的聚合命令，便于定位结构问题。
升级驱动是提升安全性与功能支持的必要步骤，但务必同步修正不符合服务端语义的客户端写法。遵循“阶段归阶段、操作符归操作符”的原则，即可平滑迁移至4.6.1及以上版本。
