Spring Data MongoDB @DocumentReference 关联加载及响应问题咨询

一、target、source字段的来源与作用 #

这两个字段是@DocumentReference(lazy = true)生成的懒加载代理对象的内部元数据，不属于自定义的Book实体属性：

• source：存储当前关联文档在父文档中记录的原始ID值，即Publisher文档books数组中存储的数字ID，是代理定位待加载关联文档的依据
• target：存储代理触发加载后，从数据库查询得到的真实Book实体实例，后续访问关联属性时直接读取该字段值，避免重复查库

这两个字段出现在接口响应中，是因为JSON序列化框架（通常为Jackson）未识别代理对象，直接将所有内部字段序列化输出。
配置lazy = true后默认不会主动加载关联文档，未生效的原因是：直接将持久层实体作为接口返回值时，序列化过程会调用所有属性的getter方法，访问getBooks()时直接触发了懒加载逻辑，不仅全量查询了关联文档，还带出了代理的内部元数据字段。

二、保留关联关系且不自动加载关联文档的实现方案 #

你的现有存储是纯ID数组结构，不要使用@DBRef（会修改存储格式为带$ref的结构，破坏现有数据兼容性），推荐以下三个可落地方案，按推荐优先级排序：

方案1：使用DTO投影（最推荐，生产环境通用方案） #

不要直接把MongoDB持久化实体类返回给API层，专门定义接口响应DTO：

// 接口返回专用的Publisher DTO，仅定义需要返回的字段
public record PublisherResp(
    String id,
    String name,
    String arconym,
    Integer foundationYear,
    List<Long> books // 直接对应数据库里存的ID数组，不关联Book实体
){}

查询时直接用Spring Data的类-based投影或者接口投影接收结果，框架查询时只会读取books数组里存的原始ID值，完全不会触发@DocumentReference的关联查询，从根源上避免多余数据库调用，也不会出现代理序列化的冗余字段问题，不需要修改任何现有数据库结构。

方案2：配置Jackson识别懒加载代理，避免意外触发加载 #

如果部分场景需要直接返回实体类，手动注册Spring Data MongoDB提供的Jackson扩展模块到ObjectMapper中，高版本Spring Boot引入spring-boot-starter-data-mongodb后会自动注册该模块，未自动注册时可手动添加配置：

@Bean
public Module mongoLazyModule() {
    return new org.springframework.data.mongodb.core.mapping.MongoSpringDataModule();
}

配置后Jackson会识别@DocumentReference的懒加载代理：

• 未触发加载的代理只会序列化存储的原始ID值，不会触发数据库查询
• 已触发加载的代理只会序列化真实Book实体的字段，不会输出target、source冗余元数据
  注意：该方案需要保证序列化前没有业务代码主动访问getBooks()方法，否则还是会触发关联查询。

方案3：手动维护关联关系，完全规避框架代理 #

如果想要最高的可控性，可以完全去掉@DocumentReference注解，拆分持久化字段和业务关联字段：

class Publisher {
    // ... 其他字段
    @Field("books") // 直接映射数据库中存储的ID数组，和现有存储结构完全一致
    private List<Long> bookIds;

    @Transient // 标记为不持久化，不会修改数据库存储结构
    private List<Book> books;
}

默认查询Publisher时只会读取bookIds的ID值，不会产生任何额外查询。需要关联Book数据时，手动用ID批量查询（用in语句一次性查所有关联Book，不要循环单查，避免N+1问题），再手动赋值给books字段即可，是否加载关联、返回什么字段完全可控，没有代理的序列化坑。

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