Spring Boot 3.1.0项目降级Hibernate至5.6.x可行性及实现方法

可行性结论 #

直接将Hibernate从6.x降级至5.6.x不可行。核心原因：

• Spring Boot 3.1.0基于Jakarta EE 9+规范，API包前缀为jakarta.*；
• Hibernate 5.6.x仅支持传统Java EE规范，API包前缀为javax.*；
• 两者API包名完全不兼容，会引发编译错误、类找不到、方法调用失败等一系列问题。

可行的替代方案 #

1. 回退到Spring Boot 3.1.0默认的Hibernate版本 #

Spring Boot 3.1.0的父POM已绑定经过兼容性验证的Hibernate 6.2.7.Final版本，该版本大概率不存在你遇到的SqlTreeCreationException异常。

Maven配置调整步骤：

• 如果你的POM中手动指定了Hibernate 6.6.2的依赖，直接移除该配置；
• 若依赖传递引入了高版本Hibernate，可通过dependencyManagement锁定版本为6.2.7.Final，修改后的POM如下：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.1.0</version>
</parent>

<!-- 手动锁定Hibernate版本（可选，仅当自动依赖拉取异常时使用） -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.hibernate.orm</groupId>
            <artifactId>hibernate-core</artifactId>
            <version>6.2.7.Final</version>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>  
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-security</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.security</groupId>
        <artifactId>spring-security-taglibs</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-logging</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <optional>true</optional>
    </dependency>
    <dependency>
        <groupId>org.mariadb.jdbc</groupId>
        <artifactId>mariadb-java-client</artifactId>
    </dependency>
</dependencies>

2. 临时修复异常（无需版本调整） #

针对你遇到的org.hibernate.sql.ast.SqlTreeCreationException异常，可先排查实体映射或查询逻辑：

• 检查是否存在复杂嵌套的多表关联映射；
• 验证自定义JPQL/SQL中的表别名、关联条件是否合法；
• 简化查询逻辑，逐步定位触发异常的代码片段。

3. 等待Hibernate官方修复 #

若上述方案无效，可关注Hibernate官方仓库，待修复该BUG的新版本发布后直接升级即可。

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