Eclipse中运行旧Java项目时的JVM兼容性问题及解决方案

错误现象分析

当尝试在eclipse中运行导入的java项目时，如果遇到类似以下日志中的错误，这通常指向jvm版本兼容性问题：

java.lang.reflect.InaccessibleObjectException: Unable to make field int java.util.TimerTask.state accessible: module java.base does not "opens java.util" to unnamed module @5099f48
WARNING: System::setSecurityManager has been called by abbot.util.SystemState

这些错误信息揭示了几个关键问题：

1. InaccessibleObjectException: 这个异常表明代码尝试通过反射访问java.util.TimerTask类的内部字段state，但由于Java模块系统（Java 9及更高版本）的限制，java.base模块并未向未命名模块（通常是应用程序代码所在的模块）“开放”java.util包，导致反射访问失败。这是Java平台模块系统（JPMS）引入的强封装特性。
2. WARNING: System::setSecurityManager has been called: 这个警告指出代码调用了System::setSecurityManager方法。该方法在较新的Java版本中已被标记为“终极废弃”（terminally deprecated），并计划在未来的版本中移除。这表明应用程序或其依赖库（如abbot.jar）使用了过时的API，这些API在高版本JVM上不再被支持或行为异常。
3. javax.swing.undo.CannotUndoException: 尽管这是一个Swing相关的异常，但它可能是在上述底层兼容性问题导致其他组件初始化或行为异常后产生的次生错误。

问题根源：JVM版本不兼容

这些错误的核心原因在于，您正在尝试在一个为旧版Java（很可能是Java 8或更早版本）设计的应用程序或库，在较新的Java虚拟机（JVM，例如Java 9、11、17等）上运行。

• Java 9及更高版本引入了模块系统（JPMS），旨在提高Java平台的可维护性、安全性和性能。其中一个重要特性是强封装，它限制了对JDK内部API的反射访问。如果一个旧的应用程序依赖于反射访问这些内部API，它将在新的JVM上遇到InaccessibleObjectException。
• API废弃与移除：随着Java版本的迭代，一些旧的、不安全的或过时的API会被废弃，甚至最终被移除。System::setSecurityManager就是其中之一，它在现代Java应用中不再推荐使用。

您在VM参数中添加的-Djava.library.path=lib/java3d-1.6/windows/amd64;lib/yafaray/windows/x64是用于指定原生库（native library）的路径，这对于加载JNI（Java Native Interface）相关的库是正确的配置，但它无法解决由JVM版本兼容性引起的Java内部API访问问题。

解决方案：降级JVM至Java 8

解决这类问题的最直接和有效的方法是，将项目的运行环境（JVM）切换到一个与旧应用程序兼容的版本，通常是 Java 8 (JDK 8)。Java 8是一个长期支持（LTS）版本，它不包含Java 9及之后引入的模块系统和对内部API的强封装，因此能够很好地兼容许多遗留Java应用程序。

立即学习“Java免费学习笔记（深入）”；

以下是在Eclipse中配置项目使用Java 8的详细步骤：

一览运营宝

一览“运营宝”是一款搭载AIGC的视频创作赋能及变现工具，由深耕视频行业18年的一览科技研发推出。

41

查看详情

步骤一：安装Java Development Kit (JDK) 8

如果您尚未安装JDK 8，需要先下载并安装它。推荐从可靠的源获取，例如Adoptium (原AdoptOpenJDK) 提供的Temurin JDK 8：

• 访问 Adoptium Temurin 8 Releases
• 根据您的操作系统（Windows, macOS, Linux）和架构（x64, arm64等）下载合适的JDK 8安装包。
• 按照安装向导完成安装。

步骤二：在Eclipse中添加JDK 8作为已安装的JRE

1. 打开Eclipse。
2. 导航到 Window > Preferences。
3. 在左侧导航栏中，展开 Java > Installed JREs。
4. 点击右侧的 Add... 按钮。
5. 选择 Standard VM，然后点击 Next。
6. 点击 Directory... 按钮，然后浏览到您刚刚安装的JDK 8的根目录（例如，C:\Program Files\Eclipse Adoptium\jdk-8.0.352.10-hotspot 或 C:\Program Files\Java\jdk1.8.0_xxx）。
7. Eclipse会自动检测到JDK 8的名称和系统库。点击 Finish。
8. 确保新添加的JDK 8被勾选为默认JRE（如果您希望所有新项目都使用它），或者只是确保它出现在列表中即可。点击 Apply and Close。

步骤三：配置项目使用JDK 8

对于您导入的特定项目，需要将其构建路径配置为使用JDK 8：

1. 在Eclipse的 Package Explorer 中，右键点击您的项目。
2. 选择 Properties。
3. 在左侧导航栏中，选择 Java Build Path。
4. 切换到 Libraries 标签页。
5. 找到并选中 JRE System Library（它可能显示为 JavaSE-1.x 或其他版本）。
6. 点击 Edit... 按钮。
7. 在弹出的 JRE System Library 对话框中，选择 Alternate JRE。
8. 从下拉列表中选择您在步骤二中添加的JDK 8（例如，jdk1.8.0_xxx 或 temurin-8）。
9. 点击 Finish，然后点击 Apply and Close。

步骤四：配置运行配置使用JDK 8

即使项目构建路径设置为JDK 8，运行配置也可能默认使用工作区的默认JRE。为了确保运行时也使用JDK 8，需要进行如下配置：

1. 在Eclipse菜单栏中，点击 Run > Run Configurations...。
2. 在左侧列表中，找到并选中您的应用程序的运行配置（通常在 Java Application 下）。
3. 切换到 JRE 标签页。
4. 选择 Alternate JRE。
5. 从下拉列表中选择您在步骤二中添加的JDK 8。
6. 确认 VM arguments 选项卡中的 -Djava.library.path 参数设置正确无误。
7. 点击 Apply，然后点击 Run。

注意事项与总结

• 长期支持版本 (LTS)：Java 8是一个LTS版本，这意味着它将获得长时间的维护和支持，非常适合运行遗留应用程序。
• 向后兼容性：虽然Java通常强调向后兼容性，但Java 9引入的模块系统是一个重大改变，它影响了反射访问内部API的行为，因此旧代码在新JVM上可能会出现兼容性问题。
• 依赖库更新：如果您的项目依赖的库（例如 abbot.jar）在未来有更新版本，且这些版本已经适配了新的Java模块系统，那么升级这些库可能是另一个长期的解决方案。但在当前情况下，降级JVM是最快且最可靠的方法。
• 原生库路径：Djava.library.path参数对于需要原生库的Java应用仍然是必要的。请确保路径设置正确，并且包含的DLL/SO文件与您的操作系统和架构匹配。

通过将项目运行环境切换到Java 8，您将能够绕过Java模块系统带来的限制以及废弃API的问题，从而使旧的Java应用程序在Eclipse中正常运行。

以上就是Eclipse中运行旧Java项目时的JVM兼容性问题及解决方案的详细内容，更多请关注php中文网其它相关文章！