IDEA运行正常但Maven打包Jar在服务器报Jakarta Persistence缺失错误

1. 检查Maven依赖范围 #

java.lang.NoClassDefFoundError 核心原因是运行时找不到Jakarta Persistence的类文件，先排查pom.xml中相关依赖的<scope>配置：

• 找到jakarta.persistence-api或hibernate-core的依赖项，如果存在<scope>provided</scope>，直接删除该标签。provided表示依赖由运行环境提供，但你的服务器显然没有内置该依赖，导致打包时不会将其包含在Jar中。
• 确保依赖版本匹配：Hibernate 6.x及以上依赖Jakarta Persistence 3.x，不要混用旧版的javax.persistence-api（对应Java EE）。示例依赖配置：

<dependency>
    <groupId>jakarta.persistence</groupId>
    <artifactId>jakarta.persistence-api</artifactId>
    <version>3.1.0</version>
</dependency>
<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>6.2.0.Final</version>
</dependency>

2. 确保打包时包含所有依赖 #

默认Maven打包生成的Jar仅包含你的代码，不会打包第三方依赖，这是本地IDE运行正常但服务器报错的常见原因。解决方式有两种：

方式一：打包成Fat Jar（包含所有依赖） #

使用maven-shade-plugin生成可执行的Fat Jar，示例配置（添加到pom.xml的<build><plugins>中）：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.4.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>com.yourpackage.YourMainClass</mainClass> <!-- 替换为你的主类全路径 -->
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

执行mvn clean package后，target目录下的Jar会包含所有依赖，直接用java -jar your-app.jar运行即可。

方式二：手动管理依赖类路径 #

如果不想打包成Fat Jar，需将所有依赖Jar放到服务器的某个目录（比如lib），运行时指定类路径：

java -cp "your-app.jar:lib/*" com.yourpackage.YourMainClass

3. 验证persistence.xml的位置 #

确认persistence.xml放在src/main/resources/META-INF目录下，打包后Jar中必须存在META-INF/persistence.xml，否则JPA无法加载配置。

4. 检查Hibernate与JPA的兼容性 #

确保Hibernate版本和Jakarta Persistence API版本兼容：

• Hibernate 5.x对应Java EE的javax.persistence包
• Hibernate 6.x对应Jakarta EE的jakarta.persistence包
  不要跨版本混用，比如用Hibernate 6却依赖javax.persistence-api，会导致类路径混乱。

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