缺少JavaFX运行环境报错怎么解决？

Question

在调试完jdk8环境之后出现的问题，在网上也没有看见相应的问题和解决方案

Answer 1

引自免费微信小程序：皆我百晓生

根据您的问题描述，以下是在满足以下条件的情况下处理缺失JavaFX运行环境错误的方法：

1. 确定JavaFX版本：首先，确认您的系统是否安装了JavaFX及其相关库（如javafx-controls，javafx-extensions等）。打开命令提示符（Windows）或终端（Mac/Linux），输入以下命令来检查JavaFX是否已安装：

   java -version
   

   如果该命令显示Java version not found,这可能意味着JavaFX已被禁用或不存在。在这种情况下，您需要确保JavaFX是可用的，并且您可以安全地将其包含在项目的依赖列表中。对于Windows系统，添加以下依赖到项目文件夹（例如：C:\Program Files\Java\jdk11\bin\javac.bat，Linux系统则为PATH变量中的/usr/bin/javac)：

   <dependency>
     <groupId>org.openjfx</groupId>
     <artifactId>javafx-base</artifactId>
     <version>11.0.13</version>
   </dependency>
   

   对于macOS系统，使用以下命令：

   <dependency>
     <groupId>org.openjfx</groupId>
     <artifactId>javafx-controls</artifactId>
     <version>11.0.13</version>
   </dependency>
   

   或者，在Eclipse IDE中通过右键点击项目图标，选择"Properties > Java Build Path"，然后勾选"Add JARs... "，拖拽包含JavaFX相关的jar包（如 javafx-controls.jar，javafx-extensions.jar等）到Path变量中：

   <path>
     <dir>path/to/your/project/jars</dir>
     <include>
       * org.openjfx.javafx-base-11.0.13*.jar
     </include>
   </path>
   

   这样做的目的是将所有以javafx-base开头的JavaFX库放入JavaFX路径中，以便它可以在任何支持JavaFX的应用程序中正常工作。

2. 检查JDK版本与JavaFX版本兼容性：确保你的Java SDK（标准开发工具包）与JavaFX的发布版本保持一致。对于Java 11，建议同时使用以下版本的Java SDK和JavaFX：

   <dependency>
     <groupId>org.openjfx</groupId>
     <artifactId>javafx-sdk</artifactId>
     <version>11.0.13</version>
   </dependency>
   <dependency>
     <groupId>org.openjfx</groupId>
     <artifactId>javafx-bom</artifactId>
     <version>11.0.13</version>
     <type>pom</type>
     <scope>import</scope>
   </dependency>
   

   如果这两个依赖之间存在冲突，可以查看JDK发行版本控制面板，找出对应版本号的版本库，然后尝试按照JDK指南指定所需的最低JavaFX版本，即11.0.13。如果你已经选择了较早的版本，例如Java 9，那么可能会遇到一些兼容性问题，此时可能需要从更高版本开始补丁和支持。

3. 更新JavaFX包名及依赖》：确保JavaFX库的包名和依赖项名称与Java SDK版本匹配，如下所示：

   <dependency>
     <groupId>org.openjfx</groupId>
     <artifactId>javafx-platform</artifactId>
     <version>11.0.13</version>
     <exclusions>
       <!-- 如果该项目依赖jdk8，将上述路径替换为jdk8 -->
       <exclusion>
         <groupId>com.sun.javafx</groupId>
         <artifactId>*</artifactId>
       </exclusion>
     </exclusions>
   </dependency>
   <dependency>
     <groupId>org.openjfx</groupId>
     <artifactId>javafx-components</artifactId>
     <version>11.0.13</version>
     <exclusions>
       <!-- 如果该项目依赖jdk8，将上述路径替换为jdk8 -->
       <exclusion>
         <groupId>com.sun.javafx</groupId>
         <artifactId>*</artifactId>
       </exclusion>
     </exclusions>
   </dependency>
   <dependency>
     <groupId>org.openjfx</groupId>
     <artifactId>javafx-decklayout</artifactId>
     <version>11.0.13</version>
     <exclusions>
       <!-- 如果该项目依赖jdk8，将上述路径替换为jdk8 -->
       <exclusion>
         <groupId>com.sun.javafx</groupId>
         <artifactId>*</artifactId>
       </exclusion>
     </exclusions>
   </dependency>
   <dependency>
     <groupId>org.openjfx</groupId>
     <artifactId>javafx-mvc-applets</artifactId>
     <version>11.0.13</version>
     <exclusions>
       <!-- 如果该项目依赖jdk8，将上述路径替换为jdk8 -->
       <exclusion>
         <groupId>com.sun.javafx</groupId>
         <artifactId>*</artifactId>
       </exclusion>
     </exclusions>
   </dependency>
   
   其他相关依赖包括FXDataView、FXCollections、FXShape管理器、FXBuilder等，可以根据实际项目需求进行调整。确保这些库的名称以及它们相对于Java SDK版本和JavaFX组件版本的正确匹配。
   
   

4. 执行JavaFX编译和打包：确保所有的依赖都已经安装且配置正确后，执行以下步骤来编译和打包项目：

   mvn clean package
   

   如果在构建过程中遇到任何冲突或具体问题，比如JavaFX运行时库或类没有被正确导入，可能是由于以下原因导致的：

   a. JDK版本与JavaFX版本不兼容：例如，如果JDK版本是11.0.13，而JavaFX依赖的是JDK版本为11.0.8或更高版本的JavaFX库，可能会导致编译时错误。这时，你需要升级JDK版本以确保JavaFX和JavaFX库在目标系统的JavaFX环境下工作正常。 b. 库名拼写错误：某些JavaFX库可能有版本不同的命名规则，当调用其方法时，参数的名称或类型与API文档不符可能导致错误。例如，如果你在使用javax.swing.JButton.Button，但误用了名为button的类型或方法，会导致编译失败。 c. 未导入某个类或接口：确保在每个JavaFX组件的构造函数或初始化方法中都导入了相应的JavaFX类或接口，这是保证组件正常工作的基本要求。如果某些依赖项或组件依赖未导入，可能会引发编译错误。 d. 类加载器冲突：如果你正在使用Gradle构建项目，可能因为某一个依赖库的类加载器加载了不同版本的JavaFX类而导致的冲突。在这种情况下，你需要修改JavaFX类的classloader设置，使其只加载和加载当前项目的类加载器。

5. 错误排查与修复：一旦识别出导致错误的原因，可通过下面的步骤进行排查并针对性地修复： a. 检查JavaFX目录结构：确保项目中有正确的JavaFX模块和对应的源代码文件夹。确保所有依赖项都在项目的根目录下，并且每个模块都有相应的.class文件。 b. 查找JavaFX编译选项：查找编译器的JavaFX类和方法声明，确保使用的javafx.compile.FXMLLoader类和对应的load(XElement element)方法与JavaFX的定义相匹配。 c. 检查JavaFX属性设置：确保在类或构造函数中正确设置了类的全局属性，如javafx.application.Application.java:applicationState，这个属性存储了一个Application实例的状态信息。 d. 检查JavaFX项目依赖关系：确保JavaFX项目中的所有依赖项都是完整的，且依赖的JDK版本与你的项目中的JavaFX版本一致。 e. 手动测试：创建一个新的项目或重装项目，并手动运行缺失的JavaFX应用程序，观察可能出现的错误情况，尝试定位和修复可能存在的问题。

6. 解决JavaFX运行时库冲突：如果在运行JavaFX应用时出现异常，可以尝试通过以下步骤解决冲突： a. 添加依赖的JDK版本：移除<exclusions>标签中的JavaFX依赖项（例如<exclusion>匹配指定的JDK版本）并重新添加相应的JavaFX库。例如：

   <dependency>
     <groupId>com.sun.javafx</groupId>
     <artifactId>*</artifactId>
   </dependency>
   

   b. 修改<module>标签：将项目的所有JavaFX模块移动到<module>标签之前，这样<module>标签只会引用由<module>标签引出的JavaFX类或接口，从而避免其他模块对<module>标签依赖的影响。

   <module path="src/main/java">
     ...
   </module>
   <module path="src/main/resources/META-INF/fxml/com.example.myapp.MyApp.fxml">
     ...
   </module>
   ...
   <module path="src/main/resources/META-INF/fxml/com.example.myapp.MyOtherApp.fxml">
     ...
   </module>
   ...
   <module path="target/classes">