Spring Framework4.3.x搭配Spring Data MongoDB2.1.x使用MongoRepository报错咨询

问题根源 #

Spring Data MongoDB 2.1.x 系列依赖 Spring Framework 5.x，而你当前使用的是 Spring 4.3.30，两者版本不兼容。ReactiveTypeDescriptor 是 Spring 5 新增的反应式相关类，因此触发了找不到类的错误。

可行解决方案 #

1. 降级 Spring Data MongoDB 到兼容版本（最稳妥）

直接将 Spring Data MongoDB 版本替换为兼容 Spring 4.3.x 的分支：Spring Data MongoDB 1.10.x.RELEASE（这是最后一个支持 Spring 4.3 的系列版本）。

以 Maven 依赖配置为例：

<dependency>
    <groupId>org.springframework.data</groupId>
    <artifactId>spring-data-mongodb</artifactId>
    <version>1.10.23.RELEASE</version>
</dependency>

该方案无需修改任何业务代码，仅更换版本即可完全适配现有 Spring 4.3 环境，是优先推荐的解决方式。

2. 重写 AbstractRepositoryMetadata 的 isReactiveRepository 方法（仅临时应急）

如果无法降级 Spring Data MongoDB，可通过重写方法屏蔽反应式仓库的检查逻辑，避免触发对 Spring 5 类的依赖：

• 自定义 RepositoryMetadata 子类，继承 AbstractRepositoryMetadata 并固定返回非反应式仓库：

import org.springframework.data.repository.core.AbstractRepositoryMetadata;

public class NonReactiveRepositoryMetadata extends AbstractRepositoryMetadata {

    public NonReactiveRepositoryMetadata(Class<?> repositoryInterface) {
        super(repositoryInterface);
    }

    @Override
    public boolean isReactiveRepository() {
        // 强制返回false，跳过反应式仓库检查逻辑
        return false;
    }
}

• 自定义 MongoRepositoryFactory，替换默认的仓库元数据实现：

import org.springframework.data.mongodb.repository.support.MongoRepositoryFactory;
import org.springframework.data.mongodb.core.MongoOperations;
import org.springframework.data.repository.core.RepositoryMetadata;

public class CustomMongoRepositoryFactory extends MongoRepositoryFactory {

    public CustomMongoRepositoryFactory(MongoOperations mongoOperations) {
        super(mongoOperations);
    }

    @Override
    protected RepositoryMetadata getRepositoryMetadata(Class<?> repositoryInterface) {
        return new NonReactiveRepositoryMetadata(repositoryInterface);
    }
}

• 自定义 MongoRepositoryFactoryBean，指定使用上述工厂类：

import org.springframework.data.mongodb.repository.support.MongoRepositoryFactoryBean;
import org.springframework.data.repository.Repository;
import org.springframework.data.repository.core.support.RepositoryFactorySupport;
import org.springframework.data.mongodb.core.MongoOperations;

import java.io.Serializable;

public class CustomMongoRepositoryFactoryBean<T extends Repository<S, ID>, S, ID extends Serializable> 
        extends MongoRepositoryFactoryBean<T, S, ID> {

    @Override
    protected RepositoryFactorySupport createRepositoryFactory(MongoOperations operations) {
        return new CustomMongoRepositoryFactory(operations);
    }
}

• 在配置类中启用自定义 FactoryBean：

@Configuration
@EnableMongoRepository(
        basePackages = "com.your.package.repository", 
        repositoryFactoryBeanClass = CustomMongoRepositoryFactoryBean.class
)
public class MongoConfig {
    // 原有配置保持不变
}

该方案需要编写多个自定义类，容易引入其他潜在问题（如部分 Spring Data MongoDB 特性无法正常使用），仅适合临时应急场景。

3. 升级 Spring Framework 到 5.x 版本（彻底解决）

如果项目允许升级，可将 Spring Framework 升级到 5.1.x.RELEASE（与 Spring Data MongoDB 2.1.x 版本匹配）。升级后不仅能解决当前类找不到的问题，还能使用 Spring 5 的新特性，但需提前检查项目中其他第三方依赖的兼容性。

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