Spring-orm 5.3.22与Jakarta版Hibernate6兼容问题求助

核心冲突原因 #

Spring Framework 5.x系列（含spring-orm 5.3）基于Java EE规范，依赖javax.persistence包；而Hibernate 6.x已完全迁移到Jakarta EE规范，所有API包路径改为jakarta.persistence，二者的JPA API包路径不兼容，这是导致编译错误的直接原因。官方声称的"兼容"存在表述偏差，实际Spring 5.x仅兼容Hibernate 5.x系列。

可行解决办法 #

• 升级Spring Framework到6.x版本：Spring 6.x全面适配Jakarta EE规范，与Hibernate 6.x的jakarta.persistence包完全兼容，这是最彻底、推荐的解决方案。
• 回退Hibernate版本到5.x：若暂时无法升级Spring，只能将Hibernate降级到5.x系列，它仍支持javax.persistence，可与spring-orm 5.3正常配合使用。
• 临时过渡方案（不推荐生产环境）：通过代码迁移工具（如OpenRewrite）批量替换项目中javax.persistence为jakarta.persistence，同时引入Jakarta EE桥接包，但这种方式可能引发隐藏的兼容性问题，仅适合临时测试场景。

代码调整示例（升级Spring 6.x后） #

自定义Dialect的导入包需替换为Jakarta EE规范下的路径：

import jakarta.persistence.EntityManager;
import jakarta.persistence.PersistenceException;
import org.springframework.orm.jpa.vendor.HibernateJpaDialect;
import org.springframework.transaction.TransactionDefinition;
import org.springframework.transaction.TransactionException;
import java.sql.SQLException;

public class CustomHibernateJpaDialect extends HibernateJpaDialect {

    private static final long serialVersionUID = 1L;

    @Override
    public Object beginTransaction(final EntityManager entityManager,
            final TransactionDefinition definition)
            throws PersistenceException, SQLException, TransactionException {
        // 自定义业务逻辑
        return super.beginTransaction(entityManager, definition);
    }
}

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