JavaFX应用运行异常：调用main方法触发Class Not Found Exception

我来帮你捋捋这个ClassNotFoundException的问题——这在JavaFX项目里挺常见的，尤其是用Eclipse搭配FXML开发的时候。既然你已经搞定了空指针异常，咱们从几个关键方向排查这个类找不到的问题：

1. 先检查FXML文件的控制器类路径 #

这是最容易踩坑的点！你得确认FXML文件里的fx:controller属性是不是写对了全限定类名。比如你的控制器类在application包下，那属性值应该是application.YourControllerClassName，别漏了包名，也别拼错类名（大小写要完全一致）。

举个正确的FXML控制器声明例子：

<?xml version="1.0" encoding="UTF-8"?>
<AnchorPane xmlns:fx="http://javafx.com/fxml" fx:controller="application.MainController">
    <!-- 你的界面元素 -->
</AnchorPane>

2. 确认Eclipse的JavaFX项目配置 #

虽然你装了JavaFX插件，但还是要检查几个配置点：

• 右键项目 → Build Path → Configure Build Path，切换到Module Path标签，看看是不是已经添加了javafx.fxml、javafx.controls这些必要的JavaFX模块？漏了任何一个都可能导致加载失败。
• 如果你的项目是模块化项目（有module-info.java文件），那里面必须正确声明依赖：

  module your.module.name {
      requires javafx.controls;
      requires javafx.fxml;
      // 允许FXML加载器访问你的控制器所在的包
      opens application to javafx.fxml;
  }
  

  要是没加opens语句，FXML加载器无法反射访问你的控制器类，也会报ClassNotFoundException。

3. 检查编译后的类文件是否存在 #

有时候编译出错或者输出目录配置不对，会导致运行时找不到编译后的.class文件：

• 看看Eclipse的bin目录（或者你自定义的输出目录）里，有没有生成对应控制器类的.class文件？
• 右键项目 → Run As → Run Configurations → Java Application，切换到Classpath标签，确认你的输出目录（比如bin/application）已经被包含在类路径里。

4. 再确认主类加载FXML的路径 #

虽然你说NPE已经解决，但再核对下FXMLLoader的getResource路径是否正确。比如：

// 正确的加载方式，注意路径开头的斜杠，确保FXML在资源目录里
Parent root = FXMLLoader.load(getClass().getResource("/application/YourFXMLFile.fxml"));

如果FXML文件的位置不对，加载时也可能间接引发类找不到的错误（比如FXML加载失败时的异常信息被掩盖）。

如果以上步骤都排查完还是没解决，建议把完整的堆栈追踪信息、module-info.java内容（如果有）以及FXML文件里的控制器声明行贴出来，这样能更精准定位问题。

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