JavaFX首个HelloFX应用启动报错：NullPointerException求助

核心原因 #

这个异常的本质是FXML文件路径错误或资源未被正确打包到classpath中，导致FXMLLoader调用getResource()时返回null，触发空指针。

针对性解决方案 #

1. 对齐Gradle资源目录规范 #

Gradle默认会将src/main/resources下的文件打包到classpath，必须确保FXML文件放在这个目录下，且路径与Java类的包结构匹配：

• 示例正确结构：

  src/
    main/
      java/
        com/
          example/
            hellofx/
              MainApp.java
      resources/
        com/
          example/
            hellofx/
              hello-view.fxml
  

2. 修正FXML加载代码 #

必须使用类加载器从classpath加载资源，避免直接使用文件路径（易受工作目录影响）：

• 相对当前类包路径加载（推荐，与包结构绑定）：

  @Override
  public void start(Stage stage) throws IOException {
      FXMLLoader fxmlLoader = new FXMLLoader(MainApp.class.getResource("hello-view.fxml"));
      Scene scene = new Scene(fxmlLoader.load(), 320, 240);
      stage.setTitle("Hello!");
      stage.setScene(scene);
      stage.show();
  }
  

• 绝对路径加载（从resources根目录开始，路径前加/）：

  FXMLLoader fxmlLoader = new FXMLLoader(getClass().getResource("/com/example/hellofx/hello-view.fxml"));
  

3. 验证Gradle配置正确性 #

确保build.gradle中包含正确的JavaFX插件和资源配置：

plugins {
    id 'java'
    id 'org.openjfx.javafxplugin' version '0.0.13'
}

javafx {
    version = '17.0.12'
    modules = ['javafx.controls', 'javafx.fxml']
}

repositories {
    mavenCentral()
}

// 确保资源目录被正确识别（Gradle默认已配置，自定义过需检查）
sourceSets {
    main {
        resources {
            srcDirs = ["src/main/resources"]
        }
    }
}

4. IntelliJ环境额外检查 #

• 右键src/main/resources目录，选择Mark Directory as -> Resources Root，确保IDE将其识别为资源目录
• 执行./gradlew clean build清理旧构建产物，再运行./gradlew run，避免缓存问题
• 不要直接运行MainApp类，必须通过Gradle的run任务启动，保证类路径与构建产物一致

报错日志对应验证点 #

你的核心报错链：

Caused by: java.lang.RuntimeException: Exception in Application start method
底层：java.lang.NullPointerException: Location is required

直接指向FXMLLoader.load()时传入的location为null，按上述步骤逐一排查即可解决。

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