解决JavaFX报错缺少 JavaFX 运行时组件, 需要使用该组件来运行此应用程序

本文详细解释了JavaFX项目运行时错误的原因,并提供了三种解决方案:直接使用Java8、采用Java模块系统和使用引导类。适合新手理解并解决老项目运行问题。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

解决JavaFX报错缺少 JavaFX 运行时组件, 需要使用该组件来运行此应用程序

  很多 JavaFX 初学者在下载并运行老的 JavaFX 项目时,经常遇到下面这个错误。

错误: 缺少 JavaFX 运行时组件, 需要使用该组件来运行此应用程序

  为什么发生这种错误呢?这需要谈及 JavaFX 的历史。在 Java 8 之后,JavaFX 从 JDK 中分离出来,然后在 Java 9 时,Java 引入了 Java 模块系统。从那之后,JavaFX 要求使用 Java 模块系统来运行 JavaFX。因此,Java 8 的时候,是没有 Java 模块系统的,而且此时 JavaFX 尚未从 JDK 中分离出来(没有分离出来意味着运行 JavaFX 项目不需要添加 JavaFX 依赖),所以很多老的 JavaFX 项目使用的是 Java 8。因此,当直接使用 Java 8 以上的环境运行没有使用 Java 模块 JavaFX 老项目时就会出现如上报错。

  知道原因解决起来就很简单了。方法有很多,这里列举如下。

方法 1:使用 Java 8

  直接使用 Java 8 运行 JavaFX 项目,而且这样做了之后还无需添加 JavaFX 依赖。个人是很不建议使用这种方法的,但是很多遇到此问题的读者只是一个刚使用 JavaFX 的新人,他们拿着从网上免费下载的代码却不知道如何运行,他们只是想先试着看看运行效果,而且他们还不清楚如何引入 JavaFX 依赖,更不擅长使用 Maven 或 Gradle。那么,可以使用这种方法。从短期来看,可以省一些事情。

方法 2:使用 Java 模块系统

  使用 Java 模块系统,建议使用这种方法。这里不详细介绍什么 Java 模块系统以及它的语法,因为这不是本文的重点。构建 Java 模块系统只需要在顶级目录中添加一个模块声明文件 module-info.java。如果读者不知道应该在模块声明文件中编写什么,可以使用 IntelliJ IDEA 来新建一个 JavaFX 项目,然后生成的示例项目中就会有一个简单的 module-info.java 示例。

module com.example.demo {
    requires javafx.controls;
    requires javafx.fxml;


    opens com.example.demo to javafx.fxml;
    exports com.example.demo;
}

在这里插入图片描述

在这里插入图片描述

方法 3:使用引导类

  使用一种引导类来代理启动 JavaFX 应用。举个例子,现在笔者将 方法 2 中使用 IntelliJ IDEA 新建的 JavaFX 示例项目中的 module-info.java 删除。此时运行此项目应该会报前述的错误。现在,只需要编写一个引导类调用 JavaFX 入口 main 方法即可消除这个错误。

package com.example.demo;

public class JavaFXBootstrap {
    public static void main(String[] args) {
        HelloApplication.main(args);
    }
}

在这里插入图片描述

  因为此处没有使用模块系统,所以 Java 运行时会为其自动生成一个匿名的模块系统。可以看到编译器提出了如下警告。

X月 XX, 202X XX:XX:XX XX com.sun.javafx.application.PlatformImpl startup
警告: Unsupported JavaFX configuration: classes were loaded from 'unnamed module @1b3d156e'
评论 8
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值