Spring Boot 2转3自定义Starter（含实体与仓库）迁移问题求助

安全阿岳

2026-7-19

解决方案

问题根源

Spring Boot 3对自动配置加载机制、JPA实体扫描逻辑做了调整，原Spring Boot 2中通过自定义ImportBeanDefinitionRegistrar注册实体包的方式不再可靠，同时自动配置类的注册方式也发生了变化，导致EntityManagerFactory无法扫描到Starter中的实体类。

步骤1：更新自动配置类的注册方式

Spring Boot 3废弃了META-INF/spring.factories中配置自动类的方式，改用META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件。在你的Starter项目中创建该文件，添加自动配置类的全限定名：

com.example.starter.config.UserManagementAutoConfiguration

步骤2：调整自动配置类实现（二选一）

方案A：实现`AutoConfigurationPackages.Registrar`接口

移除自定义的StarterEntityRegistrar，让自动配置类直接实现AutoConfigurationPackages.Registrar接口，确保实体包被注册到自动配置扫描列表中：

@Configuration
@AutoConfigureBefore(JpaRepositoriesAutoConfiguration.class)
@EnableJpaRepositories(basePackages = {"com.example.starter.repository"})
public class UserManagementAutoConfiguration implements AutoConfigurationPackages.Registrar {

    @Override
    public void registerBeanDefinitions(AnnotationMetadata metadata, BeanDefinitionRegistry registry) {
        AutoConfigurationPackages.register(registry, User.class.getPackage().getName());
    }
}

方案B：直接添加`@EntityScan`注解

更简洁的方式是在自动配置类上添加@EntityScan，明确指定实体所在的包路径：

@Configuration
@AutoConfigureBefore(JpaRepositoriesAutoConfiguration.class)
@EnableJpaRepositories(basePackages = {"com.example.starter.repository"})
@EntityScan(basePackages = {"com.example.starter.model.entity"})
public class UserManagementAutoConfiguration {
}