Spring Data MongoDB中DocumentReference失效问题的分析与解决

问题背景

在使用Spring Data MongoDB的项目中，当同时引入spring-boot-starter-data-mongodb和mongodb-driver-reactivestreams依赖时，升级到Spring Boot 3.2版本后，实体类中的@DocumentReference注解字段会返回NULL值，而不是预期的代理对象。

问题现象

项目中混合使用了同步和非同步的MongoDB操作：

• 主要使用同步的MongoTemplate进行常规操作
• 仅使用Reactive Streams来实现变更流(change stream)监听

实体类中定义的@DocumentReference字段如下：

@Setter(AccessLevel.NONE)
@ReadOnlyProperty
@DocumentReference(lookup = "{'_id': {$oid: ?#{#self.parentId}}}", lazy = true)
private ParentDocument parent;

升级后，这个字段总是返回NULL，没有任何代理对象被创建。

根本原因分析

通过调试发现，问题源于Spring Boot自动配置的顺序变化：

1. 项目中同时存在同步和异步MongoDB配置
2. 两个自动配置类都会创建MappingMongoConverter bean
3. 在Spring Boot 3.2中，MongoReactiveDataAutoConfiguration比MongoDatabaseFactoryDependentConfiguration先执行
4. 异步配置使用了NoOpDbRefResolver，而同步配置需要使用DefaultDbRefResolver
5. 由于bean创建顺序变化，最终使用了错误的解析器

技术细节

两个自动配置类中的关键差异：

同步配置 (MongoDatabaseFactoryDependentConfiguration)

@Bean
@ConditionalOnMissingBean(MongoConverter.class)
MappingMongoConverter mappingMongoConverter(MongoDatabaseFactory factory, 
    MongoMappingContext context, MongoCustomConversions conversions) {
    DbRefResolver dbRefResolver = new DefaultDbRefResolver(factory);
    MappingMongoConverter mappingConverter = new MappingMongoConverter(dbRefResolver, context);
    mappingConverter.setCustomConversions(conversions);
    return mappingConverter;
}

异步配置 (MongoReactiveDataAutoConfiguration)

@Bean
@ConditionalOnMissingBean(MongoConverter.class)
public MappingMongoConverter mappingMongoConverter(MongoMappingContext context,
    MongoCustomConversions conversions) {
    MappingMongoConverter mappingConverter = new MappingMongoConverter(NoOpDbRefResolver.INSTANCE, context);
    mappingConverter.setCustomConversions(conversions);
    return mappingConverter;
}

解决方案

临时解决方案

在应用配置中显式定义MappingMongoConverter bean，覆盖自动配置：

@Bean
public MappingMongoConverter mappingMongoConverter(MongoDatabaseFactory factory, 
    MongoMappingContext context, MongoCustomConversions conversions) {
    DbRefResolver dbRefResolver = new DefaultDbRefResolver(factory);
    MappingMongoConverter mappingConverter = new MappingMongoConverter(dbRefResolver, context);
    mappingConverter.setCustomConversions(conversions);
    return mappingConverter;
}

长期建议

1. 如果项目主要使用同步操作，可以考虑移除mongodb-driver-reactivestreams依赖
2. 或者将变更流监听部分重构为完全使用Reactive方式
3. 等待Spring Boot团队修复自动配置顺序问题

技术启示

这个问题揭示了Spring Boot自动配置顺序的重要性，特别是在混合使用同步和异步组件时。开发者在引入新依赖时需要特别注意可能产生的配置冲突，特别是在主要使用同步操作的项目中引入Reactive依赖时。

对于MongoDB的文档引用功能，确保使用正确的DbRefResolver实现至关重要，同步操作必须使用DefaultDbRefResolver才能正常工作。