在 spring data mongodb 中，直接多次调用 `addcriteria()` 添加多个 `$or` 条件会触发底层 `basicdocument` 的限制报错；正确方式是将各 `$or` 条件封装为独立 `criteria` 对象，再通过 `andoperator()` 组合，最终一次性传入 `query` 构造函数。
Spring Data MongoDB 提供了高度抽象的 Criteria API，但其底层仍受限于 MongoDB Java 驱动对文档结构的校验逻辑——一个 BasicDocument 实例不允许重复键（如多个 $or）。因此，像以下写法会失败：
Query query = new Query();
query.addCriteria(Criteria.where("field1").is("value1").orOperator(Criteria.where("field2").is("value2")));
query.addCriteria(Criteria.where("field3").is("value3").orOperator(Criteria.where("field3").is(null)));
// ❌ 报错：Can't add a second '$or' expression✅ 正确做法是：先分别构建每个 $or 子条件（作为独立 Criteria），再用 andOperator() 将其合并为单一顶层条件，并直接传入 Query 构造函数。示例如下：
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
// 第一个 $or: field1 == "value1" OR field2 == "value2"
Criteria firstOr = Criteria.where("field1").is("value1")
.orOperator(Criteria.where("field2").is("value2"));
// 第二个 $or: field3 == "value3" OR field3 == null OR field3 exists (注意：exists(true) 表示字段存在且非 null)
Criteria secondOr = Criteria.where("field3").is("value3")
.orOperator(
Criteria.where("field3").is(null),
Criteria.where("field3").exists(true) // ⚠️ 注意：exists(true) ≠ is(null)，而是“字段存在”
);
// 组合成 $and: [ { $or: [...] }, { $or: [...] } ]
Criteria finalCriteria = Criteria.andOperator(firstOr, secondOr);
Query query = new Query(finalCriteria);⚠️ 关键注意事项：
- Criteria.where("field3").exists(true) 表示字段存在（且值不为 null），而 exists(false) 表示字段不存在（即 { field3: { $exists: false } }），与 is(null) 含义不同；
- 若需表达 “field3 为 null 或不存在”，应使用 orOperator(Criteria.where("field3").is(null), Criteria.where("field3").exists(false))；
- 避免链式调用 .orOperator(...) 多次作用于同一 Criteria 实例——它仅支持单次 orOperator 调用，后续调用会覆盖而非追加；
- 使用 Query(Criteria) 构造函数可确保整个条件树被序列化为单个 BSON 文档，规避多 $or 键冲突。
总结：Spring MongoDB 的 Criteria 设计强调「组合优先于叠加」。面对复杂布尔逻辑（如 $and 包含多个 $or），务必采用「分治 + 合并」策略——先拆解子条件，再用 andOperator/orOperator 显式组合，最后整体构造 Query。这是既符合驱动约束、又保持代码可读性的最佳实践。
