Spring Data MongoDB继承场景下集合名称错误问题求助

Spring Data MongoDB处理泛型Repository时，由于泛型擦除机制，默认会以父类BaseEntity的类型生成EntityInformation，导致集合名取父类类名，而非子类@Document注解指定的名称。

无需为每个实体单独创建Repository接口，只需通过以下步骤让Spring正确识别子类的集合配置：

1. 定义泛型父Repository接口 #

添加@NoRepositoryBean注解，告诉Spring不要直接实例化该接口，仅作为父类使用：

@NoRepositoryBean
public interface BaseRepository<T extends BaseEntity, ID extends Serializable> extends MongoRepository<T, ID> {
    // 可添加通用业务方法
}

2. 自定义RepositoryFactoryBean与RepositoryFactory #

核心逻辑是解析Repository接口的泛型元数据，获取实际的实体子类类型，而非擦除后的父类类型：

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

    public GenericMongoRepositoryFactoryBean(Class<? extends T> repositoryInterface) {
        super(repositoryInterface);
    }

    @Override
    protected RepositoryFactorySupport createRepositoryFactory(MongoOperations mongoOperations) {
        return new GenericMongoRepositoryFactory(mongoOperations);
    }

    private static class GenericMongoRepositoryFactory extends MongoRepositoryFactory {

        private final MongoOperations mongoOperations;

        public GenericMongoRepositoryFactory(MongoOperations mongoOperations) {
            super(mongoOperations);
            this.mongoOperations = mongoOperations;
        }

        @Override
        @SuppressWarnings("unchecked")
        protected <T, ID> EntityInformation<T, ID> getEntityInformation(Class<T> domainClass) {
            // 获取Repository的泛型元数据，拿到实际的实体子类类型
            RepositoryMetadata metadata = getRepositoryMetadata(domainClass);
            Class<T> actualDomainType = (Class<T>) metadata.getDomainType();
            // 用实际子类类型创建EntityInformation，读取子类@Document注解的集合名
            return new MappingMongoEntityInformation<>(actualDomainType, 
                mongoOperations.getConverter().getMappingContext());
        }
    }
}

3. 配置Spring使用自定义工厂类 #

在Mongo配置类中，指定repositoryFactoryBeanClass为自定义的工厂类：

@Configuration
@EnableMongoRepositories(
    basePackages = "com.yourproject.repositories",
    repositoryFactoryBeanClass = GenericMongoRepositoryFactoryBean.class
)
public class MongoConfig extends AbstractMongoClientConfiguration {

    @Override
    protected String getDatabaseName() {
        return "your_database_name";
    }

    @Override
    public MongoClient mongoClient() {
        return MongoClients.create("mongodb://localhost:27017");
    }
}

4. 注入使用泛型Repository #

直接注入指定具体泛型类型的BaseRepository即可，无需为每个实体单独定义Repository接口：

@Service
public class PersonService {
    private final BaseRepository<PersonEntity, ObjectId> personRepository;

    // 构造注入
    public PersonService(BaseRepository<PersonEntity, ObjectId> personRepository) {
        this.personRepository = personRepository;
    }

    public void savePerson(PersonEntity person) {
        personRepository.save(person);
        // 此时数据会存入PersonEntity的@Document指定的集合，而非baseEntity
    }
}

方案原理 #

自定义的RepositoryFactory会解析Repository接口的泛型元数据，获取到实际的实体子类类型（如PersonEntity），而非泛型擦除后的BaseEntity。MappingMongoEntityInformation会根据这个实际类型读取@Document注解中的集合名称，从而正确将数据存入对应集合。

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