Spring Boot 3.1.2升级后entityManagerFactory引发Java堆空间溢出问题

针对你遇到的升级后堆内存溢出问题，可从以下几个核心维度排查和解决：

1. HikariCP 配置适配调整 #

Spring Boot 3.1.x 对 HikariCP 的默认参数做了微调，仅设置 minimum-idle=2 可能不足以覆盖新的配置逻辑：

• 限制最大连接数：过大的连接池会占用大量内存，建议根据服务器配置设置合理值，如：

  spring.datasource.hikari.maximum-pool-size=8
  

• 缩短空闲连接存活时间：避免闲置连接长期占用资源，配置示例：

  spring.datasource.hikari.idle-timeout=600000
  spring.datasource.hikari.max-lifetime=1800000
  

• 关闭自动提交（业务允许的情况下）：减少不必要的数据库交互开销，配置：

  spring.datasource.hikari.auto-commit=false
  

2. Hibernate 6.2.x 适配检查 #

Spring Boot 3.1.x 绑定的 Hibernate 版本为 6.2.x，相比 3.0.x 的 6.1.x 有不少变更：

• 确认实体类注解全量替换：检查所有 javax.persistence.* 注解是否都替换为 jakarta.persistence.*，遗漏的注解会导致 Hibernate 加载实体时出现异常，进而引发内存泄漏
• 关闭自动 Schema 生成：生产环境下禁用 spring.jpa.hibernate.ddl-auto=create/update，改为手动维护 Schema，自动生成过程会消耗大量内存，配置：

  spring.jpa.hibernate.ddl-auto=none
  

• 调整二级缓存配置：如果使用二级缓存，需确保缓存提供商适配 Jakarta 规范（如 Ehcache 3），避免缓存对象无法回收导致内存堆积
• 开启批量操作：减少数据库交互次数，降低内存占用，配置：

  spring.jpa.properties.hibernate.jdbc.batch_size=20
  

3. JVM 内存参数优化 #

Spring Boot 3.x 对内存的需求相比 2.x 有所提升，建议显式指定堆内存大小：

• 在启动脚本中添加参数（根据服务器配置调整）：

  -Xms2g -Xmx4g
  

• 排查内存泄漏：使用 jmap 生成堆转储文件，再通过 MAT 等工具分析，查看是否有大量未回收的 EntityManagerFactory 相关对象或实体类实例堆积

4. 依赖冲突排查 #

检查 pom.xml 中是否残留旧版本的 javax 相关依赖，即使实体类代码已替换，依赖冲突仍可能导致类加载异常和内存问题：

• 执行 mvn dependency:tree 分析依赖树，排除所有 javax.* 相关依赖，示例：

  <dependency>
      <groupId>xxx</groupId>
      <artifactId>xxx</artifactId>
      <exclusions>
          <exclusion>
              <groupId>javax.persistence</groupId>
              <artifactId>javax.persistence-api</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

5. 初始化逻辑优化 #

如果应用启动时有大量数据预加载或初始化任务，需优化逻辑：

• 分批加载数据，避免一次性将大量数据加载到内存
• 检查是否存在重复执行的初始化任务，减少不必要的内存消耗

临时排查手段 #

• 开启 HikariCP 调试日志，查看连接池的创建和销毁情况：

  logging.level.com.zaxxer.hikari=DEBUG
  

• 开启 Hibernate 统计日志，监控实体加载和缓存状态：

  spring.jpa.properties.hibernate.generate_statistics=true
  logging.level.org.hibernate.stat=DEBUG
  

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