Spring Data MongoDB中嵌套文档_id字段映射问题解析

问题现象

在使用Spring Data MongoDB进行聚合查询时，开发者发现当嵌套文档和父文档都使用"id"作为字段名时，嵌套文档中的id字段会被映射为NULL。而当将嵌套文档中的id字段重命名为其他名称(如"id2")时，映射则能正常工作。

技术背景

这个问题涉及到Spring Data MongoDB对文档中_id字段的特殊处理机制。在MongoDB中，_id字段是一个特殊字段，作为文档的主键标识。Spring Data MongoDB在对象映射时，对_id字段有特殊的转换规则：

1. 默认情况下，Java类中的"id"字段会被映射到MongoDB文档的"_id"字段
2. 这种映射是双向的 - 查询时文档的"_id"也会被映射回Java对象的"id"字段

问题根源

在聚合查询的投影阶段，开发者显式地将嵌套文档中的字段命名为"id"，这与Spring Data MongoDB的默认映射规则产生了冲突。具体表现为：

1. 聚合管道中使用了{id: {$toString: '$$estado._id'}}这样的投影
2. Spring Data MongoDB在映射时会尝试将这个"id"字段当作特殊字段处理
3. 但由于上下文环境复杂，导致映射失败，最终结果为NULL

解决方案

针对这个问题，有以下几种解决方案：

方案一：使用@Field注解明确指定映射关系

@Field("id")
private String id;

这种方式明确告诉框架如何映射字段，避免了自动映射的歧义。

方案二：修改聚合管道，使用标准_id命名

将聚合管道中的投影改为使用MongoDB标准的"_id"字段名：

... in: { _id: {$toString: '$$estado._id'}, h: 'child'}...

这样符合Spring Data MongoDB的默认映射规则。

方案三：使用不同的字段名

如示例中所示，使用"id2"等其他字段名可以避免冲突，但这可能不符合业务需求。

最佳实践建议

1. 在涉及复杂聚合查询时，建议始终使用@Field注解明确字段映射关系
2. 对于_id字段，尽量保持与MongoDB一致使用"_id"命名
3. 在设计文档结构时，避免在不同层级使用相同的字段名，特别是像"id"这样的特殊字段
4. 在编写聚合管道时，注意投影阶段的字段命名与Java实体类的映射关系

总结

Spring Data MongoDB对_id字段有特殊的处理逻辑，这在简单查询中工作良好，但在复杂的聚合查询中可能会产生意外的映射结果。理解框架的映射规则并适当使用注解可以避免这类问题。在性能关键的场景下，修改聚合管道使其符合框架的映射规则通常是更好的选择。