JavaFX应用IntelliJ打包可执行Jar遇NullPointerException问题求助

我之前也维护过一个依赖堆成山的JavaFX项目，用IntelliJ的Artifact打包时踩过不少坑，结合你的场景，给你几个针对性的解决方案：

一、依赖未被正确打包（最常见的坑） #

如果运行Jar时弹出ClassNotFoundException或NoClassDefFoundError，大概率是IntelliJ默认的Artifact配置没把第三方依赖拉进来：

• 打开IntelliJ的File > Project Structure > Artifacts
• 选中你创建的JavaFX Jar artifact，在右侧Output Layout里点击+ > Library Files，把所有项目依赖都添加进去
• 重新构建Artifact，依赖会被打包到Jar内部的lib目录（不建议直接合并到主Jar，容易触发类冲突）
• 如果是模块化项目（带module-info.java），要确保所有依赖模块都在requires语句里声明，且Artifact配置包含了模块路径

二、启动时提示JavaFX Runtime缺失 #

哪怕打包了依赖，有时候还是会碰到这个错误，因为JavaFX核心模块需要特定运行时支持：

• 别用普通的java -jar命令启动，要么用JavaFX的javafx:run插件打包，要么在启动命令里指定模块路径：

  java --module-path "/path/to/javafx-sdk/lib" --add-modules javafx.controls,javafx.fxml -jar your-app.jar
  

• 更省心的方式是用jpackage打包成原生安装包（exe/dmg/deb），它会自动包含JavaFX运行时：
  1. 先构建好包含所有依赖的Jar（可以用Maven/Gradle的shadowJar插件，或者IntelliJ Artifact）
  2. 终端运行：

     jpackage --name YourApp --input ./target --main-jar your-app.jar --main-class com.yourpackage.MainClass --type app-image
     

  生成的独立应用目录，用户不需要额外安装JDK/JavaFX

三、Jar体积过大（大型应用通病） #

如果你的Jar因为依赖太多变得臃肿，可以做这些优化：

• 用ProGuard或R8做代码混淆与缩减，移除未使用的类、方法和资源
• 模块化项目用jlink生成自定义JRE，只保留应用需要的模块和依赖，能大幅压缩体积
• 别把所有依赖都塞进主Jar，用lib目录单独存放依赖Jar，主Jar只放自己的代码，启动时用-cp指定类路径

四、资源文件无法加载（FXML/图片/字体等） #

如果运行Jar时找不到FXML或图片，大概率是资源路径写错了：

• 别用绝对路径加载资源，改用类加载器的方式：

  // 正确写法
  FXMLLoader loader = new FXMLLoader(getClass().getResource("/com/yourpackage/view/MainView.fxml"));
  // 错误写法（绝对路径，打包后失效）
  FXMLLoader loader = new FXMLLoader(new File("src/main/resources/com/yourpackage/view/MainView.fxml").toURI().toURL());
  

• 检查IntelliJ的Artifact配置，确保src/main/resources目录的内容被包含到Jar中（默认是包含的，但可以在Output Layout里确认）

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