升级Spring Boot 3至Jakarta EE时Hibernate SessionFactory构建失败

核心原因 #

Spring Boot 3.0.2配套的Hibernate 6.x对CTE（公共表表达式）的处理逻辑做了调整，CteInsertStrategy要求所使用的数据库方言必须支持通过CTE执行UPDATE或DELETE操作。如果方言配置错误、数据库版本不兼容，或者存在不被支持的CTE INSERT用法，就会触发SessionFactory构建失败的异常。

解决方案 #

• 修正数据库方言配置
  确保JPA配置中指定的Hibernate方言是适配当前数据库版本的Hibernate 6.x方言：

  • MySQL 8.x及以上：使用org.hibernate.dialect.MySQL8Dialect
  • PostgreSQL 9.1+：使用org.hibernate.dialect.PostgreSQLDialect
  • Oracle 12c+：使用org.hibernate.dialect.OracleDialect
    示例配置（application.properties）：

  spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
  

• 升级数据库版本
  部分旧版本数据库不支持CTE的UPDATE/DELETE操作：

  • MySQL需升级至5.7及以上
  • PostgreSQL需升级至9.1及以上
    确认数据库版本满足要求，若过低则进行升级。

• 排查依赖冲突
  执行mvn dependency:tree（Maven）或./gradlew dependencies（Gradle）检查依赖树，确保没有引入Hibernate 5.x的旧版本依赖，避免与Spring Boot 3.x配套的Hibernate 6.x版本冲突。如有冲突，手动排除旧版本依赖。

• 调整CTE相关JPQL语句
  若项目中存在自定义JPQL使用CTE执行INSERT操作，且当前方言不支持该用法，需修改语句为方言兼容的写法，或调整业务逻辑规避这种场景。

内容的提问来源于stack exchange，提问作者ROUISSI Mohamed ALi