IntelliJ插件调用JPA库报错：找不到指定EntityManager的持久化提供者

一、"No Persistence provider for EntityManager named"异常分析与修复 #

这个问题核心是IntelliJ插件的类加载机制与普通Java程序存在差异，导致类库的JPA配置或Hibernate依赖未被正确加载，属于配置+类加载适配问题，修复步骤如下：

1. 显式指定JPA持久化提供者 #

在类库的META-INF/persistence.xml中明确指定Hibernate的提供者类，避免依赖JPA的自动查找（插件类加载环境下自动查找逻辑容易失效）：

<persistence xmlns="http://xmlns.jcp.org/xml/ns/persistence"
             version="2.2">
    <persistence-unit name="YourPersistenceUnitName" transaction-type="RESOURCE_LOCAL">
        <!-- 强制指定Hibernate提供者 -->
        <provider>org.hibernate.jpa.HibernatePersistenceProvider</provider>
        <!-- 注册实体类 -->
        <class>com.yourpackage.YourEntity</class>
    </persistence-unit>
</persistence>

2. 调整插件项目的依赖与资源打包规则 #

IntelliJ插件默认不会自动合并依赖类库的META-INF资源，需要在插件的build.gradle中配置资源打包，确保类库的persistence.xml被纳入插件运行时类路径：

sourceSets {
    main {
        resources {
            // 从依赖jar中提取并合并META-INF资源
            from configurations.runtimeClasspath.collect {
                it.isDirectory() ? it : zipTree(it).matching {
                    include 'META-INF/**'
                }
            }
        }
    }
}

同时确保插件对类库的依赖使用implementation，保证运行时能获取到类库及Hibernate的完整依赖：

dependencies {
    implementation project(':your-library-module')
    // 若类库未内置Hibernate依赖，需手动引入适配版本
    implementation 'org.hibernate:hibernate-core:5.6.14.Final'
    implementation 'org.hibernate.javax.persistence:hibernate-jpa-2.1-api:1.0.2.Final'
}

3. 适配插件的类加载器 #

在插件代码中创建EntityManagerFactory时，指定使用插件自身的类加载器，避免类加载隔离导致找不到提供者：

// 获取插件主类的类加载器
ClassLoader pluginClassLoader = YourPluginEntryClass.class.getClassLoader();
// 加载.env配置属性（后续步骤说明）
Map<String, String> jpaProps = loadEnvProps();
// 传入类加载器创建EntityManagerFactory
EntityManagerFactory emf = Persistence.createEntityManagerFactory(
    "YourPersistenceUnitName",
    jpaProps,
    pluginClassLoader
);

4. 放弃Fat-Jar形式依赖类库 #

Fat-Jar会将所有依赖合并到单个jar中，在IntelliJ插件的类加载环境下容易引发类冲突或资源加载异常。建议类库以普通jar发布，插件直接依赖原始类库，由插件的Gradle配置统一管理依赖链。

二、将持久化单元配置存入.env并运行时读取 #

完全可以实现，核心思路是摆脱静态persistence.xml的限制，改为运行时从.env加载属性并动态构建JPA配置，具体有两种实现方式：

方式1：动态传入配置到Persistence.createEntityManagerFactory #

保留一个极简的persistence.xml（仅定义持久化单元名称），从.env读取所有配置后以Map形式传入创建方法：

// 从.env读取配置（假设已通过自定义方法或第三方库将.env加载到环境变量）
Map<String, String> jpaProps = new HashMap<>();
jpaProps.put("javax.persistence.jdbc.url", System.getenv("DB_URL"));
jpaProps.put("javax.persistence.jdbc.user", System.getenv("DB_USER"));
jpaProps.put("javax.persistence.jdbc.password", System.getenv("DB_PASSWORD"));
jpaProps.put("hibernate.dialect", System.getenv("HIBERNATE_DIALECT"));
jpaProps.put("hibernate.hbm2ddl.auto", System.getenv("HIBERNATE_HBM2DDL_AUTO"));

// 传入动态属性创建EntityManagerFactory
EntityManagerFactory emf = Persistence.createEntityManagerFactory(
    "YourPersistenceUnitName",
    jpaProps,
    YourPluginEntryClass.class.getClassLoader()
);

方式2：直接用Hibernate API构建配置（无需persistence.xml） #

跳过JPA的persistence.xml，直接使用Hibernate的Configuration类动态构建配置：

Configuration hibernateConfig = new Configuration();
// 从.env加载核心配置
hibernateConfig.setProperty("hibernate.connection.url", System.getenv("DB_URL"));
hibernateConfig.setProperty("hibernate.connection.username", System.getenv("DB_USER"));
hibernateConfig.setProperty("hibernate.connection.password", System.getenv("DB_PASSWORD"));
hibernateConfig.setProperty("hibernate.dialect", System.getenv("HIBERNATE_DIALECT"));
// 注册实体类
hibernateConfig.addAnnotatedClass(YourEntity.class);

// 转换为JPA的EntityManagerFactory
EntityManagerFactory emf = hibernateConfig.buildSessionFactory()
                                          .unwrap(EntityManagerFactory.class);

这种方式完全摆脱静态配置文件的约束，所有配置都从.env动态读取，更适配插件的运行环境。

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