JavaFX界面显示失败报错：找不到主类与NoClassDefFoundError

一、Could not find or load main class Main.SongApp 错误原因 #

这个错误说明你运行程序时指定的主类是Main.SongApp，但你的SongApp类没有放在Main包下（代码里看不到package Main;声明）。

解决方法：

• 如果SongApp确实在默认包下（无package声明），运行时直接指定主类名为SongApp，不要加Main.前缀。
• 若要把SongApp放在Main包下，在SongApp.java顶部添加package Main;，同时调整文件目录结构，将SongApp.java移入Main文件夹（符合Java包结构规范）。

二、java.lang.NoClassDefFoundError: javafx/application/Application 错误原因 #

从Java 11开始，JavaFX不再包含在JDK中，需单独配置JavaFX SDK或依赖：

解决方法（分场景） #

1. 命令行运行

先下载JavaFX SDK，运行时指定模块路径与所需模块：

java --module-path "本地javafx-sdk/lib目录路径" --add-modules javafx.controls,javafx.fxml SongApp

将本地javafx-sdk/lib目录路径替换为你电脑上JavaFX SDK的lib目录绝对路径。

2. IDE（IntelliJ/Eclipse）运行

• 添加JavaFX SDK为项目库：
  • IntelliJ：打开项目结构 → 库 → 添加 → Java → 选中JavaFX SDK的lib目录。
  • Eclipse：右键项目 → 构建路径 → 添加外部归档 → 选中JavaFX SDK lib下所有jar包。
• 配置VM运行参数：在运行配置中添加：

  --module-path "本地javafx-sdk/lib目录路径" --add-modules javafx.controls,javafx.fxml
  

三、解决上述错误后可能遇到的潜在问题 #

1. FXML路径错误 #

你写的FXML加载路径/SongLibraryProject/ControllerTing/SongLib.fxml可能不符合类路径结构：

• 确保FXML文件实际位置与代码路径匹配，比如Maven/Gradle项目中，文件需放在src/main/resources/SongLibraryProject/ControllerTing/下；普通项目要保证文件在类路径的对应目录里。
• 可先尝试相对路径，比如SongLib.fxml（若和SongApp同目录），再逐步调整到正确位置。

2. 控制器不匹配 #

FXML文件中指定的控制器是SongLibrary.View.Controller，但你的控制器类是SongLibController且无package声明，这会导致FXML加载失败：

• 修改FXML的fx:controller属性为SongLibController（若控制器在默认包下）。
• 或给SongLibController添加正确的package声明，比如package SongLibrary.View;，同时将文件移入对应包结构的目录中。

内容的提问来源于stack exchange，提问作者Harry