为Spring Boot JPA项目添加module-info后导致项目启动失败

我之前也碰到过一模一样的问题——把Spring Boot JPA项目改成Java Module（为了配合JavaFX用jlink打包）后，启动就炸出这个Unable to resolve persistence unit root URL的错误，根源就是Module的类资源访问机制和传统类路径不一样，Spring默认的扫描逻辑找不到持久化单元的根路径了。结合你的错误栈，给你几个可行的解决步骤：

1. 显式指定持久化单元根位置 #

Spring在Module环境下没法自动推断持久化单元的根路径，所以我们得手动给它指出来。

如果你是用Java配置类（比如你的PersistenceJPAConfig），就在LocalContainerEntityManagerFactoryBean的配置里加上一行：

@Bean
public LocalContainerEntityManagerFactoryBean entityManagerFactory() {
    LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
    em.setDataSource(dataSource());
    em.setPackagesToScan("de.mkmstock.jpa.entity");
    // 关键：指定根位置为当前模块的类路径根
    em.setPersistenceUnitRootLocation("classpath:/");
    // 剩下的JPA适配器、方言配置保持不变
    HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
    em.setJpaVendorAdapter(vendorAdapter);
    em.setJpaProperties(additionalProperties());
    return em;
}

要是用配置文件（application.properties/yaml），直接加这行就行：

spring.jpa.persistence-unit.root-location=classpath:/

2. 修正module-info.java的权限配置 #

Java Module默认是封闭的，JPA和Spring需要反射访问你的实体类、配置类，所以必须在module-info里明确授权：

module mkmstock {
    // 导出实体包，让Spring和JPA能访问到
    exports de.mkmstock.jpa.entity;
    // 打开实体包允许反射（JPA需要动态代理实体）
    opens de.mkmstock.jpa.entity to spring.core, spring.orm, org.hibernate.core;
    // 打开配置类所在包，让Spring能扫描并初始化Bean
    opens de.mkmstock.jpa.config to spring.context;
    // 打开主应用类所在包，支持Spring Boot的自动配置
    opens de.mkmstock to spring.core, spring.boot;

    // 声明依赖的模块
    requires spring.boot;
    requires spring.boot.autoconfigure;
    requires spring.context;
    requires spring.orm;
    requires spring.data.jpa;
    requires javax.persistence.api;
    requires org.hibernate.core;
    requires java.sql;
    // JavaFX相关依赖（根据你的项目需求添加）
    requires javafx.controls;
    requires javafx.fxml;
}

这里要注意：opens关键字是给反射用的，exports是给正常类访问用的，两者都不能少。

3. 检查资源访问权限 #

如果你的项目里有persistence.xml，确保它放在src/main/resources/META-INF下，并且module-info没有限制这个路径的访问。如果没有这个文件也没关系，Spring Boot会自动生成，但要保证实体类所在的包被setPackagesToScan正确覆盖到。

4. 验证依赖的模块化兼容性 #

Spring Boot 2.4+对Java Module支持不错，但要确保你的依赖都是模块化的（或者是自动模块）。可以用mvn dependency:tree命令检查一下，要是有非模块化的依赖，可能会导致类路径冲突，这时候可能需要调整依赖版本或者添加额外的模块声明。

按这几步调整后，应该就能解决那个Bean创建失败的问题了——本质就是让Spring和JPA在Module环境下能正确找到和访问到需要的类与资源。

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