本文旨在解决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，并在项目构建路径中引用它。
操作步骤：
下载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）：
4.0.0 com.example my-javafx-app 1.0-SNAPSHOT 17 17 17.0.2 org.openjfx javafx-controls ${javafx.version} org.openjfx javafx-fxml ${javafx.version} org.openjfx javafx-graphics ${javafx.version} win org.openjfx javafx-maven-plugin 0.0.8 default-cli com.example.myjavafxapp/com.example.myjavafxapp.NewClass
注意事项：
- 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依赖管理。
