Spring Boot 3迁移后应用启动停滞于JpaMetamodelMappingContext初始化

排查与解决方案 #

1. 校验依赖版本兼容性 #

Spring Boot 3要求适配JPA 3.0规范，对应Hibernate 6.0+版本，需确保项目依赖无版本冲突：

• 检查pom.xml中spring-boot-starter-data-jpa为3.x版本，禁止手动引入5.x版本的Hibernate依赖。
• 若使用元模型生成，hibernate-jpamodelgen需匹配Hibernate 6.x版本，示例配置：

<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-jpamodelgen</artifactId>
    <version>6.1.7.Final</version>
    <scope>provided</scope>
</dependency>

2. 排查实体类元模型异常 #

• 检查所有JPA实体类，移除或替换JPA 3.0已废弃的注解（如旧版@GeneratedValue的GenerationType.AUTO用法、过时的实体监听注解）。
• 逐步注释实体类，定位是否为某一特定实体导致元模型加载停滞（比如实体间循环关联、复杂继承关系引发的加载问题）。

3. 诊断线程阻塞状态 #

• 使用jstack <进程PID>命令导出线程栈信息，查看主线程是否在获取EntityManagerFactory元模型时发生死锁或资源阻塞：

jstack 278870

• 同步检查数据库连接配置：确保数据库驱动版本适配（如MySQL需8.0+）、连接URL正确、数据库服务正常运行，排除连接超时或资源耗尽导致的阻塞。

4. 临时禁用元模型自动配置（仅排查用） #

若无需元模型支持，可临时禁用相关自动配置以验证启动流程：
在启动类添加注解：

@SpringBootApplication(exclude = JpaMetamodelMappingContextFactoryBean.class)

注意：此操作会影响Spring Data JPA的审计、QueryDSL等依赖元模型的功能，仅作为排查手段。

5. 调整JPA扫描与配置 #

• 检查spring.data.jpa.metamodel-scan-packages配置，确保指定的包路径正确，避免扫描大量无关类。
• 暂时关闭非必需的JPA特性（如@EnableJpaAuditing），验证是否因审计组件加载引发停滞。

内容的提问来源于stack exchange，提问作者ali akbar azizkhani