Spring Data MongoDB为何错误重写自定义聚合管道？如何规避？

这个异常重写行为来自与Spring Boot 2.2.13.RELEASE匹配的Spring Data MongoDB 3.0.x版本内置的聚合管道实体映射适配逻辑：

• 该逻辑原本的设计目的是减少开发者手动匹配实体类字段路径的成本，避免聚合路径和实体ORM映射冲突
• 但存在明确的逻辑缺陷：遍历解析$project、$group等阶段的字段映射时，只要检测到映射值是形如$xxx.yyy的MongoDB字段路径引用，且该路径在绑定的实体类（即Repository泛型的InData）的字段映射树中存在，就会强制把当前映射的输出key替换为这个引用路径本身
• 对应到你的场景：第一个$project阶段写的映射为'fieldNested': '$field.nested'，映射值$field.nested刚好匹配实体里的嵌套字段路径，触发了错误判定，原本的输出keyfieldNested被直接替换成field.nested，最终形成无法正常执行的聚合管道。

可根据项目实际约束选择以下任意方案，均可绕开自动重写逻辑：

• 调整临时字段命名，避开元数据扫描匹配
  将原本用来承接嵌套值的临时字段名，改成不在实体字段映射树中的命名（比如加下划线前缀），扫描逻辑不会对这类字段做路径绑定替换。例如把fieldNested改为_temp_nested_value，调整后的管道完全可以正常被解析、执行。
• 改用MongoTemplate手动执行聚合，绕过@Aggregation注解的前置解析
  不依赖@Aggregation注解的字符串解析逻辑，直接注入MongoTemplate手动构建聚合管道，执行过程完全跳过Spring Data对管道内容的自动改写，100%按照自定义结构发送到MongoDB。
• 升级组件版本
  该自动重写的逻辑缺陷在Spring Data MongoDB 3.2.x版本中已被修复，后续版本不再会强制替换自定义的映射key。如果项目迭代允许，可将Spring Boot升级到2.4.x及以上版本，从根源上解决这类解析问题。

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