Mac下JavaFX+Maven项目运行抛出NSException问题求助

排查与修复步骤 #

• 匹配JavaFX与JDK版本
  确保pom.xml里的JavaFX依赖版本和当前使用的JDK版本兼容，比如JDK17对应JavaFX17及以上，JDK21对应JavaFX21及以上。修改pom.xml中的依赖版本：

  <dependency>
      <groupId>org.openjfx</groupId>
      <artifactId>javafx-controls</artifactId>
      <version>21.0.2</version> <!-- 替换为匹配JDK的版本 -->
  </dependency>
  

• 规范Launcher与App类实现
  Launcher类需保持最简启动逻辑，避免多余代码：

  public class Launcher {
      public static void main(String[] args) {
          App.main(args);
      }
  }
  

  同时确认App类正确继承Application并实现start方法：

  public class App extends Application {
      @Override
      public void start(Stage primaryStage) {
          primaryStage.setTitle("JavaFX Demo");
          primaryStage.setScene(new Scene(new Label("Hello JavaFX"), 300, 200));
          primaryStage.show();
      }
  
      public static void main(String[] args) {
          launch(args);
      }
  }
  

• 调整Eclipse运行配置

  1. 右键项目 → Run As → Run Configurations
  2. 选中对应的Java Application配置，切换到Arguments标签
  3. 在VM arguments中添加模块路径配置（若Maven未自动处理）：

     --module-path ${project_classpath:你的项目名称} --add-modules javafx.controls,javafx.fxml
     

     替换你的项目名称为实际项目名，或直接使用Maven生成的模块路径。

• 清理重建项目

  • 执行Maven命令：mvn clean install
  • 在Eclipse中点击Project → Clean，选择当前项目完成清理

• 适配macOS平台依赖
  NSInternalInconsistencyException是macOS特有异常，需确保pom.xml中添加对应CPU架构的JavaFX依赖分类器：

  <dependency>
      <groupId>org.openjfx</groupId>
      <artifactId>javafx-controls</artifactId>
      <version>21.0.2</version>
      <classifier>mac-aarch64</classifier> <!-- 基于CPU架构选mac-x86_64或mac-aarch64 -->
  </dependency>
  

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