Maven打包后Spring环境中Hibernate映射失效问题

问题详情 #

使用以下Hibernate及连接池依赖的Spring Boot项目，经Maven打包为可执行Jar后出现功能异常：

<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>6.1.6.Final</version>
</dependency>
<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-community-dialects</artifactId>
    <version>6.1.6.Final</version>
</dependency>
<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-hikaricp</artifactId>
    <version>6.1.6.Final</version>
</dependency>
<dependency>
    <groupId>com.zaxxer</groupId>
    <artifactId>HikariCP</artifactId>
    <version>5.0.1</version>
</dependency>

具体表现：

• 调用SQLWorker类的getEntityList方法获取实体列表时，IDE内运行可返回完整填充的实体对象列表；但打包成Jar后运行，仅返回实体主键组成的字符串列表
• 数据表存在至少2条数据时可稳定复现该问题
• 非Spring项目打包为可执行Jar时无此异常

可能的解决方案 #

1. 修正Spring Boot打包插件的优化配置 #

Spring Boot的spring-boot-maven-plugin可能对实体类进行了过度字节码优化，导致Hibernate无法识别实体映射。可以调整插件配置：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <!-- 禁用字节码优化 -->
        <optimize>false</optimize>
        <!-- 或者明确指定实体类所在包，避免被优化排除 -->
        <includes>
            <include>
                <groupId>你的项目groupId</groupId>
                <artifactId>你的项目artifactId</artifactId>
            </include>
        </includes>
    </configuration>
</plugin>

2. 确保Hibernate实体扫描与Native Query映射正确 #

• 在Spring Boot启动类上添加@EntityScan注解，明确指定实体类所在包：

  @SpringBootApplication
  @EntityScan(basePackages = "com.your.project.entities")
  public class YourApplication {
      public static void main(String[] args) {
          SpringApplication.run(YourApplication.class, args);
      }
  }
  

• 检查getEntityList方法中Native Query的写法，确保正确关联实体类：

  // 正确示例：指定实体类作为查询结果类型
  public <R> List<R> getEntityList(String sql, Class<R> entityClass) {
      return entityManager.createNativeQuery(sql, entityClass)
                          .getResultList();
  }
  

  避免仅查询主键字段，确保SQL语句是SELECT *或包含所有实体映射需要的字段。

3. 解决依赖冲突与版本兼容性 #

• 版本对齐：Hibernate 6.x仅适配Spring Boot 3.x版本，如果当前使用的是Spring Boot 2.x，需降级Hibernate到5.x系列，或升级Spring Boot到3.x版本。
• 移除重复依赖：hibernate-hikaricp已经内置依赖了HikariCP，无需单独引入com.zaxxer:HikariCP，删除该依赖项避免版本冲突。

验证步骤 #

1. 修改配置/依赖后，执行mvn clean package重新打包
2. 运行打包后的Jar文件，测试getEntityList方法的返回结果
3. 检查Jar包内部，确认实体类的.class文件及Hibernate元数据文件存在

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