JavaFX开发：解决“找不到Application类”的编译错误-java教程-PHP中文网

JavaFX开发：解决“找不到Application类”的编译错误

聖光之護

发布： 2025-11-02 17:23:00

原创

1048人浏览过

JavaFX开发：解决“找不到Application类”的编译错误

本文旨在解决javafx应用开发中常见的“uncompilable code - cannot find symbol: class application”错误。该问题通常源于所使用的jdk未包含javafx模块。教程将详细阐述此错误的根本原因，并提供两种主要的解决方案：选择集成javafx的jdk，或手动配置项目以引入openjfx sdk作为依赖，确保开发者能够顺利构建和运行javafx应用程序。

理解“找不到Application类”错误

在开发JavaFX应用程序时，如果遇到类似如下的编译或运行时错误：

Exception in thread "main" java.lang.ExceptionInInitializerError
Caused by: java.lang.RuntimeException: Uncompilable code - cannot find symbol
symbol: class Application

登录后复制

这通常意味着Java编译器或JVM无法找到javafx.application.Application类。这个错误在尝试编译或运行一个继承自Application类的JavaFX主类时尤为常见。例如，以下代码片段就可能触发此错误：

import javafx.application.Application;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.shape.Circle;
import javafx.stage.Stage;

public class NewClass extends Application {

    @Override
    public void start(Stage stage) {
        Circle circ = new Circle(40, 40, 30);
        Group root = new Group(circ);
        Scene scene = new Scene(root, 400, 300);

        stage.setTitle("My JavaFX Application");
        stage.setScene(scene);
        stage.show();
    }
}

登录后复制

错误根源：JDK与JavaFX的分离

自Java 11（及更高版本）起，JavaFX已从标准JDK中分离出来，成为一个独立的模块化库（OpenJFX）。这意味着如果你使用的是标准的OpenJDK或Oracle JDK 11+，它将不再默认包含JavaFX。因此，当你的项目尝试引用javafx.application.Application类时，如果环境没有正确配置JavaFX模块，编译器自然会报告“找不到符号”的错误。

解决方案

解决此问题主要有两种策略：

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

方案一：使用包含JavaFX的JDK发行版

最直接且对初学者友好的方法是选择一个预先集成了JavaFX的JDK发行版。一些供应商提供了这样的JDK，例如：

Liberica JDK (Full version): 由BellSoft提供，包含完整的JavaFX支持。
ZuluFX: 由Azul提供，是Zulu OpenJDK与OpenJFX的捆绑版本。

操作步骤：

从上述供应商的官方网站下载并安装对应版本的JDK。
在你的开发环境中（IDE或命令行）配置使用这个新的JDK。
重新编译并运行你的JavaFX应用程序。

这种方法的好处是配置简单，无需额外下载和配置JavaFX SDK。

方案二：手动添加OpenJFX作为项目依赖

如果你希望继续使用标准的OpenJDK或Oracle JDK，你需要将OpenJFX库作为外部依赖添加到你的项目中。这通常涉及下载OpenJFX SDK，并在项目构建路径中引用它。

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

查看详情

操作步骤：

下载OpenJFX SDK： 访问OpenJFX官方网站（https://openjfx.io/），导航到“Downloads”部分，下载与你的JDK版本兼容的OpenJFX SDK（例如，openjfx-*-sdk.zip）。解压到一个易于访问的目录，例如C:\path\to\javafx-sdk。
配置项目构建路径（以IntelliJ IDEA为例）：
- 打开你的JavaFX项目。
- 进入File -> Project Structure...。
- 在左侧选择Libraries，点击+号，选择Java。
- 导航到你解压的OpenJFX SDK目录，选择lib文件夹，点击OK。
- 点击OK将库添加到项目中。
- 在Modules下，选择你的项目模块，进入Dependencies标签页。
- 点击+号，选择Library -> JavaFX SDK（你刚刚添加的库）。确保其作用域为Compile和Runtime。
配置运行/调试参数： 即使添加了库，运行时JVM也需要知道JavaFX模块的位置。
- 进入Run -> Edit Configurations...。
- 选择你的应用程序配置。
- 在VM options字段中添加以下参数：
```
--module-path C:\path\to\javafx-sdk\lib --add-modules javafx.controls,javafx.fxml,javafx.graphics
```
  登录后复制
  请将C:\path\to\javafx-sdk\lib替换为你实际的OpenJFX SDK lib目录路径。--add-modules参数列出了你的应用程序实际使用的JavaFX模块，javafx.graphics通常是必须的，javafx.controls和javafx.fxml根据需求添加。
命令行编译与运行： 如果你在命令行下编译和运行，你需要使用--module-path和--add-modules参数：
- 编译：
```
javac --module-path C:\path\to\javafx-sdk\lib --add-modules javafx.controls,javafx.fxml,javafx.graphics YourApp.java
```
  登录后复制
- 运行：
```
java --module-path C:\path\to\javafx-sdk\lib --add-modules javafx.controls,javafx.fxml,javafx.graphics YourApp
```
  登录后复制
  同样，请替换C:\path\to\javafx-sdk\lib为实际路径。

使用构建工具（推荐）

对于更复杂的项目，强烈推荐使用Maven或Gradle等构建工具来管理JavaFX依赖。这些工具可以自动化下载和配置OpenJFX模块，大大简化了开发流程。

Maven示例（pom.xml）：

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>my-javafx-app</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <javafx.version>17.0.2</javafx.version> <!-- 根据你的JDK版本选择合适的JavaFX版本 -->
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-controls</artifactId>
            <version>${javafx.version}</version>
        </dependency>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-fxml</artifactId>
            <version>${javafx.version}</version>
        </dependency>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-graphics</artifactId>
            <version>${javafx.version}</version>
            <classifier>win</classifier> <!-- 根据你的操作系统选择，例如mac, linux -->
        </dependency>
        <!-- 其他JavaFX模块根据需要添加 -->
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.openjfx</groupId>
                <artifactId>javafx-maven-plugin</artifactId>
                <version>0.0.8</version> <!-- 确保使用最新版本 -->
                <executions>
                    <execution>
                        <!-- Default configuration for running with: mvn clean javafx:run -->
                        <id>default-cli</id>
                        <configuration>
                            <mainClass>com.example.myjavafxapp/com.example.myjavafxapp.NewClass</mainClass>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

登录后复制

注意事项：

JavaFX版本兼容性： 确保你下载的OpenJFX SDK版本与你使用的JDK版本兼容。通常，OpenJFX的LTS版本与Java LTS版本（如Java 11, 17, 21）有良好的兼容性。
操作系统分类器： 在Maven或Gradle中添加javafx-graphics等模块时，通常需要为不同的操作系统指定classifier（例如win, mac, linux），以确保下载正确的平台特定库。
模块化应用： JavaFX本身是模块化的。如果你的应用程序也是模块化的（使用了module-info.java），你需要在其中添加requires javafx.controls;等声明。

总结

“找不到Application类”的错误是JavaFX开发中一个常见的环境配置问题。理解JavaFX自Java 11起与JDK分离的背景是解决问题的关键。通过选择一个预集成JavaFX的JDK，或者手动配置项目以引入OpenJFX SDK，并正确设置JVM运行时参数，开发者可以有效地解决此问题，从而顺利进行JavaFX应用程序的开发。对于大型或团队项目，强烈推荐使用Maven或Gradle等构建工具来自动化JavaFX依赖管理。

以上就是JavaFX开发：解决“找不到Application类”的编译错误的详细内容，更多请关注php中文网其它相关文章！