[toc]
# EMT4J使用说明

> EMT4J 是一个 Java 版本迁移兼容性检测工具，主要用于识别代码或依赖库在 **Java 8→11** 和 **11→17** 升级过程中可能遇到的不兼容问题。它通过预定义规则（如 API 废弃、模块系统限制、JVM 参数变化等）扫描代码或 JAR 包，快速定位潜在风险，帮助开发者提前修复问题，确保迁移后应用正常运行。

> [EMT4J——Java版本迁移检测工具](https://cloud.tencent.com/developer/article/2593269) 

- 如下使用EMT4J扫描Jar包后的报告

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-2726701/7d8ae29a87d0261ec2f1ccea1612cf30.png)
- 分类目录

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-2726701/7897d30257eabe50961854d9414f85b7.png)

## 使用说明

> 使用该工具检测之前，建议先把项目中的JDK版本、SpringBoot相关依赖及第三方依赖升级到对应的版本再使用该工具。如果直接使用该工具，会检测出很多低版本依赖的问题。

> 以下拿 https://github.com/adoptium/emt4j/tree/v0.8.0 版本来改造，因为 master 分支还是个 SNAPSHOT 版本，不是很稳定

1、使用插件的方式运行

- 将以下配置添加到 pom.xml 文件（如果是多模块项目，则添加到根 pom.xml 文件）：

```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>
                
                <files>target/xxx.jar</files>
            </configuration>
        </plugin>
    </plugins>
</build>
```

- 然后运行以下命令：

```bat
mvn process-test-classes
```

- EMT4J 的报告将在项目目录中生成。

2、直接在项目目录下运行以下命令，无需修改 pom.xml 文件：

> 前提条件，需要使用对应目标的JDK版本来执行，如执行的是8-17，需要使用17来执行该命令

```bat
# 以默认配置运行，默认检测的版本范围是 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
```

```bat
# 通过 `-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

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-2726701/16bc2edb70ce43a7e4b830a49191917b.png)

- 对应 xml 扫描规则配置：

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-2726701/425ccb0e4d46c69ac12153a9f99db7f0.png)

- 如果去掉某个规则，直接注释对应的规则，有的规则不只是注释 `<rule/>`，还需要在对应的 cfg 文件中去掉包路径才不会扫描这个规则

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-2726701/b17416093966a8f1bde9b6ebf5ebcd7f.png)
### 去掉以下规则

1、从JDK 9,java version的schema发生了变化

```bash
从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输出不一致

```java
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` |
| **年份后是空格**           | **年份后是逗号**            |

```bash
如：位置: 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不一致

```java
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 标准下荷兰语默认使用星期日**              |

```bash
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的规则。这些只是被弃用了，还没有被删掉，扫描出来的太多了，大多都是一些低版本的三方包，把对应的三方包升级下就行

```bash
Deprecated的API后续可能会删除,存在潜在不兼容的风险

修复：参考标记为deprecated的API javadoc的说明替换为相应建议的API
```



### 全部规则

#### 8-11 规则：

#### 标题 1. JDK internal API (JDK内部API)

- **作用**：检测使用 `sun.*` 等JDK内部API的情况
- **优先级**：p4
- **说明**：JDK 9+ 移除了内部API，使用会导致兼容性问题

####  2. System classloader not instance of URLClassLoader

- **作用**：检测系统类加载器是否仍是 `URLClassLoader` 的子类
- **优先级**：p1
- **说明**：JDK 9+ 系统类加载器不再是 `URLClassLoader` 的子类

####  3. Arrays.asList().toArray return type changed

- **作用**：检测 `Arrays.asList().toArray()` 返回类型变化
- **优先级**：p1
- **说明**：JDK 9+ 中返回类型从 `Object[]` 变为特定类型数组

####  4. Get java version

- **作用**：检测获取Java版本的代码
- **优先级**：p1
- **说明**：JDK 9+ 中Java版本获取方式有变化

####  5. JPMS require add-exports

- **作用**：检测需要添加 `add-exports` 的模块系统代码
- **优先级**：p3
- **说明**：JDK 9+ 引入模块系统，需要显式导出包

####  6. JPMS require add-opens

- **作用**：检测需要添加 `add-opens` 的模块系统代码
- **优先级**：p3
- **说明**：JDK 9+ 引入模块系统，需要显式打开包

####  7. DateFormat incompatible with CLDR

- **作用**：检测 `DateFormat` 在CLDR区域设置下的不兼容问题
- **优先级**：p3
- **说明**：JDK 11 使用 CLDR 时区数据，与 JDK 8 不兼容

####  8. NumberFormat incompatible with CLDR

- **作用**：检测 `NumberFormat` 在CLDR区域设置下的不兼容问题
- **优先级**：p3
- **说明**：JDK 11 使用 CLDR 时区数据，与 JDK 8 不兼容

####  9. Calendar#getFirstDayOfWeek incompatible with CLDR

- **作用**：检测 `Calendar#getFirstDayOfWeek` 在CLDR区域设置下的不兼容问题
- **优先级**：p3
- **说明**：JDK 11 使用 CLDR 时区数据，与 JDK 8 不兼容

####  10. java.util.regex.Pattern.compile flags check

- **作用**：检测 `Pattern.compile()` 在JDK 11中添加的标志检查
- **优先级**：p1
- **说明**：JDK 11 中 `Pattern.compile()` 添加了标志检查

####  11. JVM Option not compatible

- **作用**：检测不兼容的JVM选项
- **优先级**：p1
- **说明**：JDK 8 和 JDK 11 的JVM选项有变化

####  12. Remove CORBA

- **作用**：检测使用CORBA的代码
- **优先级**：p4
- **说明**：CORBA在JDK 11中已被移除

####  13. Removed API

- **作用**：检测已移除的API
- **优先级**：p1
- **说明**：JDK 11中移除了部分API

####  14. Incompatible Jar

- **作用**：检测不兼容的JAR包
- **优先级**：p1
- **说明**：某些JAR包在JDK 11中不兼容

####  15. Deprecated API

- **作用**：检测已废弃的API
- **优先级**：p4
- **说明**：JDK 11中废弃了部分API



#### 11-17 规则：

#### 1. Remove Nashorn

- **作用**：检测使用Nashorn的代码
- **优先级**：p3
- **说明**：Nashorn在JDK 11中已移除，在JDK 17中完全移除

####  2. Deprecate the Applet API for Removal

- **作用**：检测使用Applet API的代码
- **优先级**：p4
- **说明**：Applet API在JDK 11中已废弃，在JDK 17中将被移除

####  3. Remove RMI Activation

- **作用**：检测使用RMI Activation的代码
- **优先级**：p4
- **说明**：RMI Activation在JDK 11中已被移除

####  4. Cannot get security class's field

- **作用**：检测无法获取安全类字段的代码
- **优先级**：p1
- **说明**：JDK 11+ 中安全类的字段访问被限制

####  5. JVM Option not compatible

- **作用**：检测不兼容的JVM选项
- **优先级**：p1
- **说明**：JDK 11 和 JDK 17 的JVM选项有变化

####  6. Incompatible Jar

- **作用**：检测不兼容的JAR包
- **优先级**：p1
- **说明**：某些JAR包在JDK 17中不兼容

####  7. Deprecated API

- **作用**：检测已废弃的API
- **优先级**：p4
- **说明**：JDK 17中废弃了部分API

EMT4J 是一个 Java 版本迁移兼容性检测工具，主要用于识别代码或依赖库在 Java 8→11 和 11→17 升级过程中可能遇到的不兼容问题。它通过预定义规则（如 API 废弃、模块系统限制、JVM 参数变化等）扫描代码或 JAR 包，快速定位潜在风险，帮助开发者提前修复问题，确保迁移后应用正常运行。

EMT4J定制规则版：Java 8→17迁移兼容性检测与规则优化实战

后端

编程语言

开发工具

EMT4J是一款专业的Java版本迁移检测工具，帮助开发者快速识别Java8→11和11→17升级过程中的兼容性问题。支持Maven插件和命令行两种使用方式，自动扫描代码和依赖库中的API废弃、模块系统限制、JVM参数变化等问题，生成详细报告。提供规则自定义功能，可灵活调整检测范围，确保应用平稳升级。

Java

AI驱动 智领未来

tools

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

EMT4J定制规则版：Java 8→17迁移兼容性检测与规则优化实战-腾讯云开发者社区-腾讯云

EMT4J定制规则版：Java 8→17迁移兼容性检测与规则优化实战

EMT4J定制规则版：Java 8→17迁移兼容性检测与规则优化实战

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐