产品中心
目录
EMT4J 是一个 Java 版本迁移兼容性检测工具，主要用于识别代码或依赖库在 Java 8→11 和 11→17 升级过程中可能遇到的不兼容问题。它通过预定义规则（如 API 废弃、模块系统限制、JVM 参数变化等）扫描代码或 JAR 包，快速定位潜在风险，帮助开发者提前修复问题，确保迁移后应用正常运行。
如下使用EMT4J扫描Jar包后的报告
分类目录
使用该工具检测之前，建议先把项目中的JDK版本、SpringBoot相关依赖及第三方依赖升级到对应的版本再使用该工具。如果直接使用该工具，会检测出很多低版本依赖的问题。
以下拿 https://github.com/adoptium/emt4j/tree/v0.8.0 版本来改造，因为 master 分支还是个 SNAPSHOT 版本，不是很稳定
1、使用插件的方式运行
将以下配置添加到 pom.xml 文件（如果是多模块项目，则添加到根 pom.xml 文件）：
<build>
<plugins>
<plugin>
<groupId>org.eclipse.emt4j</groupId>
<artifactId>emt4j-maven-plugin</artifactId>
<version>0.8.0-rules-internal</version>
<executions>
<execution>
<phase>process-test-classes</phase>
<goals>
<goal>check</goal>
</goals>
</execution>
</executions>
<configuration>
<fromVersion>8</fromVersion>
<toVersion>17</toVersion>
<outputFile>report.html</outputFile>
<!--指定扫描的jar包-->
<files>target/xxx.jar</files>
</configuration>
</plugin>
</plugins>
</build>
然后运行以下命令：
mvn process-test-classes
EMT4J 的报告将在项目目录中生成。
2、直接在项目目录下运行以下命令，无需修改 pom.xml 文件：
前提条件，需要使用对应目标的JDK版本来执行，如执行的是8-17，需要使用17来执行该命令
# 以默认配置运行，默认检测的版本范围是 JDK 8 → JDK 11
mvn process-test-classes org.eclipse.emt4j:emt4j-maven-plugin:0.8.0-rules-internal:check
# 指定JDK8-17范围
mvn process-test-classes org.eclipse.emt4j:emt4j-maven-plugin:0.8.0-rules-internal:check -DfromVersion=8 -DtoVersion=17
# 通过 `-D` 指定输出文件和优先级
mvn process-test-classes org.eclipse.emt4j:emt4j-maven-plugin:0.8.0-rules-internal:check -DoutputFile=xxx-report.html -Dpriority=p1
详细的命令介绍和使用，请访问官网：https://github.com/adoptium/emt4j/tree/v0.8.0
规则文件在：emt4j\emt4j-common\src\main\resources\default\rule
对应 xml 扫描规则配置：
如果去掉某个规则，直接注释对应的规则，有的规则不只是注释 <rule/>，还需要在对应的 cfg 文件中去掉包路径才不会扫描这个规则
1、从JDK 9,java version的schema发生了变化
从JDK 9开始，Java版本号的格式发生了变化：
旧格式（JDK 8及之前）：1.x（例如 1.8.0_381）
新格式（JDK 9+）：MAJOR.MINOR.SECURITY.PATCH（例如 9.0.1, 11.0.4, 17）
如：
位置: file:/D:/emt4j-0.8.0/admin/xxx/target/xxx.jar!/BOOT-INF/lib/byte-buddy-1.10.22.jar!/net/bytebuddy/ClassFileVersion$VersionLocator$ForLegacyVm.class, 目标: net.bytebuddy.ClassFileVersion$VersionLocator$ForLegacyVm
位于 byte-buddy-1.10.22.jar
问题：这个类使用了旧的版本号格式（1.x）来判断Java版本，在JDK 9+上会失效。
例如：if (System.getProperty("java.version").startsWith("1.8"))
→ 在JDK 9+中，java.version 返回 9.0.1，所以条件永远不成立。
大多都是一些三方包会被扫描到
2、JDK 11中时区数据为CLDR,java.text.DateFormat的使用默认的style进行format时在JDK 8和JDK 11输出不一致
DateFormat df = DateFormat.getDateTimeInstance(DateFormat.DEFAULT, DateFormat.DEFAULT);
System.out.println(df.format(new Date()));
JDK 8的输出: Jan 14, 2021 11:17:37 AM ; JDK 11的输出: Jan 14, 2021, 11:16:45 AM 区别在于年份后面,对于JDK 8是空格,但是对于JDK 11是逗号.
| JDK 8 | JDK 11 |
|---|---|
Jan 14, 2021 11:17:37 AM | Jan 14, 2021, 11:16:45 AM |
| 年份后是空格 | 年份后是逗号 |
如：位置: file:/D:/emt4j-0.8.0/admin/xxx/target/xxx.jar!/BOOT-INF/lib/liquibase-core-4.8.0.jar!/liquibase/dbdoc/HTMLWriter.class, 目标: liquibase.dbdoc.HTMLWriter
修复：
1. 增加 "-Djava.locale.providers=COMPAT"到java选项,从而将默认时区与JDK 8的时区数据保持兼容
2. 在使用DateFormat的时候避免使用默认的locale,而是显式指定Locale.
3、java.util.Calendar.getFirstDayOfWeek对于某些输入返回值在JDK 8和JDK 11不一致
Locale locale1 = Locale.forLanguageTag("nl");
System.out.println(new GregorianCalendar(locale1).getFirstDayOfWeek());
JDK 8的输出是2,但是JDK 11的输出是1
| JDK 8 | JDK 11 |
|---|---|
Locale.forLanguageTag("nl") → 星期一（返回 2） | Locale.forLanguageTag("nl") → 星期日（返回 1） |
| 荷兰语默认使用星期一为一周起始 | CLDR 标准下荷兰语默认使用星期日 |
JDK 11 采用 CLDR 时区数据，而 JDK 8 用旧版数据。Locale 未指定区域时，JDK 11 会按 CLDR 规则处理。
位置: file:/D:/emt4j-0.8.0/admin/xxx/target/xxx.jar!/BOOT-INF/lib/logback-core-1.2.13.jar!/ch/qos/logback/core/util/TimeUtil.class, 目标: ch.qos.logback.core.util.TimeUtil
修复：
1. 增加 "-Djava.locale.providers=COMPAT"到java选项,从而将默认时区与JDK 8的时区数据保持兼容
2. 在上面的场景中实例化Locale时,同时提供语言和区域，而不仅仅只提供语言
4、代码使用了JDK中标记为Deprecated的API
去掉了8-11、11-17中针对过期API的规则。这些只是被弃用了，还没有被删掉，扫描出来的太多了，大多都是一些低版本的三方包，把对应的三方包升级下就行
Deprecated的API后续可能会删除,存在潜在不兼容的风险
修复：参考标记为deprecated的API javadoc的说明替换为相应建议的API
作用：检测使用 sun.* 等JDK内部API的情况
优先级：p4
说明：JDK 9+ 移除了内部API，使用会导致兼容性问题
作用：检测系统类加载器是否仍是 URLClassLoader 的子类
优先级：p1
说明：JDK 9+ 系统类加载器不再是 URLClassLoader 的子类
作用：检测 Arrays.asList().toArray() 返回类型变化
优先级：p1
说明：JDK 9+ 中返回类型从 Object[] 变为特定类型数组
作用：检测获取Java版本的代码
优先级：p1
说明：JDK 9+ 中Java版本获取方式有变化
作用：检测需要添加 add-exports 的模块系统代码
优先级：p3
说明：JDK 9+ 引入模块系统，需要显式导出包
作用：检测需要添加 add-opens 的模块系统代码
优先级：p3
说明：JDK 9+ 引入模块系统，需要显式打开包
作用：检测 DateFormat 在CLDR区域设置下的不兼容问题
优先级：p3
说明：JDK 11 使用 CLDR 时区数据，与 JDK 8 不兼容
作用：检测 NumberFormat 在CLDR区域设置下的不兼容问题
优先级：p3
说明：JDK 11 使用 CLDR 时区数据，与 JDK 8 不兼容
作用：检测 Calendar#getFirstDayOfWeek 在CLDR区域设置下的不兼容问题
优先级：p3
说明：JDK 11 使用 CLDR 时区数据，与 JDK 8 不兼容
作用：检测 Pattern.compile() 在JDK 11中添加的标志检查
优先级：p1
说明：JDK 11 中 Pattern.compile() 添加了标志检查
作用：检测不兼容的JVM选项
优先级：p1
说明：JDK 8 和 JDK 11 的JVM选项有变化
作用：检测使用CORBA的代码
优先级：p4
说明：CORBA在JDK 11中已被移除
作用：检测已移除的API
优先级：p1
说明：JDK 11中移除了部分API
作用：检测不兼容的JAR包
优先级：p1
说明：某些JAR包在JDK 11中不兼容
作用：检测已废弃的API
优先级：p4
说明：JDK 11中废弃了部分API
作用：检测使用Nashorn的代码
优先级：p3
说明：Nashorn在JDK 11中已移除，在JDK 17中完全移除
作用：检测使用Applet API的代码
优先级：p4
说明：Applet API在JDK 11中已废弃，在JDK 17中将被移除
作用：检测使用RMI Activation的代码
优先级：p4
说明：RMI Activation在JDK 11中已被移除
作用：检测无法获取安全类字段的代码
优先级：p1
说明：JDK 11+ 中安全类的字段访问被限制
作用：检测不兼容的JVM选项
优先级：p1
说明：JDK 11 和 JDK 17 的JVM选项有变化
作用：检测不兼容的JAR包
优先级：p1
说明：某些JAR包在JDK 17中不兼容
作用：检测已废弃的API
优先级：p4
说明：JDK 17中废弃了部分API
