打包Jar运行Discord Bot时触发javax.persistence.PersistenceException异常

运行Jar文件时出现以下异常：

Exception in thread "main" javax.persistence.PersistenceException: Unable to build entity manager factory
        at org.hibernate.jpa.HibernatePersistenceProvider.createEntityManagerFactory(HibernatePersistenceProvider.java:83)
        at javax.persistence.Persistence.createEntityManagerFactory(Persistence.java:79)
        at javax.persistence.Persistence.createEntityManagerFactory(Persistence.java:54)
        at ch.ydavid.pizzabot.DAO.GuildConfigDAO.<init>(GuildConfigDAO.java:12)
        at ch.ydavid.pizzabot.manager.DynamicVoiceManager.<init>(DynamicVoiceManager.java:18)
        at ch.ydavid.pizzabot.manager.GeneralManager.<init>(GeneralManager.java:5)
        at ch.ydavid.pizzabot.Main.main(Main.java:32)
Caused by: org.hibernate.jpa.boot.archive.spi.ArchiveException: Could not build ClassFile
        at org.hibernate.jpa.boot.scan.spi.ClassFileArchiveEntryHandler.toClassFile(ClassFileArchiveEntryHandler.java:88)
        at org.hibernate.jpa.boot.scan.spi.ClassFileArchiveEntryHandler.handleEntry(ClassFileArchiveEntryHandler.java:65)
        at org.hibernate.jpa.boot.archive.internal.JarFileBasedArchiveDescriptor.visitArchive(JarFileBasedArchiveDescriptor.java:176)
        at org.hibernate.jpa.boot.scan.spi.AbstractScannerImpl.scan(AbstractScannerImpl.java:72)
        at org.hibernate.jpa.boot.internal.EntityManagerFactoryBuilderImpl.scan(EntityManagerFactoryBuilderImpl.java:723)
        at org.hibernate.jpa.boot.internal.EntityManagerFactoryBuilderImpl.<init>(EntityManagerFactoryBuilderImpl.java:219)
        at org.hibernate.jpa.boot.spi.Bootstrap.getEntityManagerFactoryBuilder(Bootstrap.java:51)
        at org.hibernate.jpa.HibernatePersistenceProvider.getEntityManagerFactoryBuilder(HibernatePersistenceProvider.java:182)
        at org.hibernate.jpa.HibernatePersistenceProvider.getEntityManagerFactoryBuilderOrNull(HibernatePersistenceProvider.java:131)
        at org.hibernate.jpa.HibernatePersistenceProvider.getEntityManagerFactoryBuilderOrNull(HibernatePersistenceProvider.java:88)
        at org.hibernate.jpa.HibernatePersistenceProvider.createEntityManagerFactory(HibernatePersistenceProvider.java:69)
        ... 6 more

针对这个问题，可尝试以下解决方案：

• 检查打包配置，确保构建Fat Jar
  普通Jar不会包含完整依赖和编译文件，必须构建可执行的Fat Jar。如果用Maven，配置maven-shade-plugin；如果用Gradle，配置shadow插件，确保所有依赖、实体类的.class文件都被正确打包。解压Jar验证：实体类所在包下的.class文件是否存在且大小正常。

• 在persistence.xml中明确指定实体类
  Hibernate在Jar环境下可能无法自动扫描实体类，手动在<persistence-unit>中添加<class>标签指定所有实体类：

  <persistence-unit name="PizzaBotPU" transaction-type="RESOURCE_LOCAL">
      <!-- 其他数据源、Hibernate属性配置 -->
      <class>ch.ydavid.pizzabot.entity.GuildConfig</class>
      <!-- 其他实体类按此格式逐一添加 -->
  </persistence-unit>
  

• 排查依赖冲突与版本兼容性
  确保Hibernate核心、JPA API版本匹配（例如Hibernate 5.x对应JPA 2.1/2.2）。检查构建文件（pom.xml/build.gradle），排除重复的JPA API依赖，避免版本冲突导致字节码解析失败。

• 确保Java环境版本一致
  本地开发环境（IntelliJ）和Jar运行环境（包括Docker）的Java版本必须一致，比如都使用OpenJDK 11。Docker镜像选择对应版本的Java基础镜像，避免因字节码版本不兼容导致解析错误。

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