多模块Spring项目中创建单个LocalContainerEntityManagerFactoryBean的方案求助

我之前在多模块Spring项目里也碰到过一模一样的实体整合问题，试了好几种方法，下面这几个方案亲测可行，你可以根据自己的项目情况选：

方案1：Spring Boot 项目直接用 @EntityScan（最省心） #

如果你的主项目是Spring Boot，那这个方法最简单。只需要在主启动类或者配置类上加上@EntityScan注解，把主项目和所有依赖JAR里的实体包路径都列进去就行：

@SpringBootApplication
@EntityScan(basePackages = {
    "com.your.main.project.entities",  // 主项目实体包
    "com.your.dependency.jar1.entities",  // 第一个依赖JAR的实体包
    "com.your.dependency.jar2.entities"   // 第二个依赖JAR的实体包
})
public class MainApplication {
    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class, args);
    }
}

要是依赖JAR的实体包有统一的前缀（比如都以com.your.*.entities结尾），还可以用通配符简化：@EntityScan(basePackages = "com.your.*.entities")。Spring会自动扫描所有符合路径的带@Entity注解的类，整合到同一个EntityManagerFactory里。

方案2：手动配置 LocalContainerEntityManagerFactoryBean 时指定扫描包 #

如果是传统Spring项目（非Boot），或者需要更精细的控制，可以直接在配置LocalContainerEntityManagerFactoryBean的时候，把所有需要扫描的实体包通过packagesToScan()方法加进去：

@Configuration
@EnableTransactionManagement
public class JpaConfig {

    @Autowired
    private DataSource dataSource;

    @Bean
    public LocalContainerEntityManagerFactoryBean entityManagerFactory() {
        LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
        em.setDataSource(dataSource);
        // 把主项目和所有依赖JAR的实体包都列在这里
        em.setPackagesToScan(
            "com.your.main.project.entities",
            "com.your.dependency.jar1.entities",
            "com.your.dependency.jar2.entities"
        );
        em.setPersistenceUnitName("combinedPersistenceUnit");

        HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
        em.setJpaVendorAdapter(vendorAdapter);
        em.setJpaProperties(additionalProperties());

        return em;
    }

    private Properties additionalProperties() {
        Properties properties = new Properties();
        properties.setProperty("hibernate.hbm2ddl.auto", "update");
        properties.setProperty("hibernate.dialect", "org.hibernate.dialect.MySQL8Dialect");
        return properties;
    }
}

这种方式直接明了，缺点是如果依赖JAR比较多，需要逐个确认实体包路径，但胜在稳定可靠。

方案3：修复 BeanPostProcessor 覆盖问题（适配多模块） #

你之前用BeanPostProcessor的思路是对的，只是踩了“覆盖”的坑——每个模块的BeanPostProcessor都直接调用setPersistenceUnitPostProcessors()，导致之前的配置被覆盖。正确的做法是追加而不是覆盖，代码示例如下：

@Component
public class ModuleEntityScannerPostProcessor implements BeanPostProcessor {

    // 当前模块要扫描的实体包
    private static final String CURRENT_MODULE_ENTITY_PACKAGE = "com.your.dependency.jar.entities";

    @Override
    public Object postProcessBeforeInitialization(Object bean, String beanName) throws BeansException {
        if (bean instanceof LocalContainerEntityManagerFactoryBean) {
            LocalContainerEntityManagerFactoryBean emfb = (LocalContainerEntityManagerFactoryBean) bean;
            
            // 先获取已有的PostProcessor列表，没有的话新建一个
            List<PersistenceUnitPostProcessor> existingPostProcessors = Optional.ofNullable(emfb.getPersistenceUnitPostProcessors())
                    .map(Arrays::asList)
                    .orElseGet(ArrayList::new);
            
            // 添加当前模块的扫描处理器
            existingPostProcessors.add(createEntityScannerPostProcessor());
            
            // 重新设置回去，注意是追加不是覆盖
            emfb.setPersistenceUnitPostProcessors(existingPostProcessors.toArray(new PersistenceUnitPostProcessor[0]));
        }
        return bean;
    }

    private PersistenceUnitPostProcessor createEntityScannerPostProcessor() {
        return persistenceUnit -> {
            // 扫描当前模块的@Entity类
            ClassPathScanningCandidateComponentProvider scanner = new ClassPathScanningCandidateComponentProvider(false);
            scanner.addIncludeFilter(new AnnotationTypeFilter(Entity.class));
            
            Set<BeanDefinition> entityBeanDefs = scanner.findCandidateComponents(CURRENT_MODULE_ENTITY_PACKAGE);
            for (BeanDefinition def : entityBeanDefs) {
                try {
                    Class<?> entityClass = Class.forName(def.getBeanClassName());
                    persistenceUnit.addManagedClassName(entityClass.getName());
                } catch (ClassNotFoundException e) {
                    // 这里可以根据项目情况处理异常，比如打日志
                    log.error("Failed to load entity class: {}", def.getBeanClassName(), e);
                }
            }
        };
    }
}

每个依赖JAR模块都可以创建这样一个BeanPostProcessor，指定自己的实体包路径。这样所有模块的扫描处理器都会被添加到列表里，不会互相覆盖，最终所有实体都会被整合到同一个EntityManagerFactory中。

注意事项 #

• 确保所有实体类都正确标注了@Entity注解，并且类路径能被Spring访问到；
• 多模块项目中，要确保每个模块的BeanPostProcessor都能被Spring扫描到（比如加上@Component，或者在配置类里手动注册）；
• 如果用packagesToScan方法，注意不要漏写任何一个实体包，否则对应的实体不会被识别。

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