如何将Hibernate从4.3升级至5.2适配JDK10及相关依赖版本选型

嘿，刚好处理过类似的升级场景，来给你详细说说～

核心结论：相关依赖必须同步升级 #

Hibernate 5.2相对于4.3.x有不少底层API和依赖结构的变化，再加上JDK10的兼容性要求，大部分关联依赖都需要调整版本，不然很容易出现类找不到、API不兼容或者运行时异常。

需要升级的关键依赖及适配版本 #

下面针对你提到的pom片段，列出必须调整的依赖项：

1. Hibernate核心及关联模块 #

首先把hibernate.version从4.3.11.Final升级到5.2.x系列的稳定版本，比如5.2.18.Final（这是5.2分支最后几个稳定版之一，兼容性最好）。

2. JPA API依赖 #

Hibernate 4.3.x实现的是JPA 2.0，而5.2.x实现的是JPA 2.1。如果你的pom中单独引入了javax.persistence-api，需要把版本升级到2.1：

<dependency>
    <groupId>javax.persistence</groupId>
    <artifactId>javax.persistence-api</artifactId>
    <version>2.1</version>
</dependency>

3. 数据库驱动 #

JDK10对JDBC驱动的兼容性要求更高，旧版本驱动可能无法识别JDK10的新特性或已移除的API：

• MySQL：需要升级到mysql-connector-java:8.0.20+
• Oracle：需要升级到ojdbc8及以上版本
• PostgreSQL：需要升级到postgresql:42.2.10+

4. Hibernate Validator（验证框架） #

如果项目用了Hibernate Validator，旧版本（比如5.1.x）和Hibernate 5.2不兼容，且不支持JDK10，需要升级到6.0.x系列，比如6.0.17.Final：

<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.0.17.Final</version>
</dependency>

5. 字节码增强工具 #

Hibernate 5.2默认使用ByteBuddy代替了CGLIB作为字节码增强工具：

• 如果之前依赖CGLIB，建议替换为ByteBuddy，版本选1.9.10（和Hibernate 5.2.18.Final完美匹配）
• 若坚持用CGLIB，需要升级到3.2.10+，确保兼容JDK10

6. JTA事务API（如果用到） #

如果项目使用了JTA事务，需要把javax.transaction-api升级到1.2版本，这是Hibernate 5.2的依赖要求：

<dependency>
    <groupId>javax.transaction</groupId>
    <artifactId>javax.transaction-api</artifactId>
    <version>1.2</version>
</dependency>

升级后的pom示例片段 #

调整后的properties部分大概是这样：

<properties>
    <hibernate.version>5.2.18.Final</hibernate.version>
    <java.version>10</java.version>
    <javax.persistence.version>2.1</javax.persistence.version>
    <hibernate.validator.version>6.0.17.Final</hibernate.version>
    <bytebuddy.version>1.9.10</bytebuddy.version>
</properties>

额外注意事项 #

• 升级后务必跑全量单元测试和集成测试，Hibernate 5.2废弃了不少4.x的API（比如SessionFactory.openSession()的某些重载、Criteria API的旧用法），可能需要少量代码调整
• JDK10中移除了一些JDK8的内部API，如果项目中有直接依赖这些API的代码，也需要一并修改

内容的提问来源于stack exchange，提问作者Cora.Kn.Kwok