IntelliJ IDEA导出JavaFX项目JAR运行无输出问题求助

问题根因 #

你遇到的是JavaFX 11及以上版本打包可运行JAR的典型兼容故障，和你怀疑的VM参数配置逻辑直接相关，本质是模块化的JavaFX SDK类被直接打包进普通非模块化JAR时，会触发类加载、本地库加载的规则冲突，且这类故障默认不会弹出控制台报错，表现就是双击JAR完全无任何响应。

第一步：先定位真实报错，避免盲目排查 #

现在双击JAR无输出，根本无法判断具体错误点，先打开Windows命令提示符，切换到生成JAR的所在目录，执行命令：
java -jar 你生成的JAR包名称.jar

此时所有运行时错误堆栈会直接打印在命令行窗口，你大概率会看到两类典型报错：

• 类加载异常：java.lang.ClassNotFoundException: javafx.application.Application，哪怕你确认WinRAR解压能在JAR里找到对应类，也会因为Java模块的类加载边界规则无法正常加载
• 本地库加载异常：java.lang.UnsatisfiedLinkError: Can't load library: .../javafxGraphics.dll，JavaFX的图形渲染依赖本地动态库，非模块化的类路径环境下会找不到关联的本地组件

注：IDE内运行正常的核心原因是，IDE启动应用时自动为你传入了配置好的VM参数，按照JavaFX模块化规则加载SDK类，和你手动生成的混打JAR的类加载路径逻辑完全不一样。

你之前操作中的常见误区 #

• 配置Artifacts时默认将所有JavaFX SDK的类、本地动态库全部打进生成的JAR内部，这种混打方式从JavaFX 11版本开始就不被官方支持，哪怕JAR里包含全部依赖文件，也无法适配模块化的类加载规则
• MANIFEST文件中仅配置Main-Class是不够的，模块路径、--add-modules的VM参数需要在JVM启动阶段传入，无法写死在MANIFEST中生效
• 你项目中src/sample路径下的图片资源，只要打JAR时正确包含在对应包路径下、采用类路径加载方式（getClass().getResource(...)），是不会导致运行无输出的，该部分可以排除问题

可直接落地的解决方案 #

方案1：快速验证问题（5分钟定位） #

保持现有打包生成的JAR不变，不要双击运行，直接用带VM参数的命令启动：
java --module-path "你本地JavaFX SDK的lib目录路径" --add-modules javafx.controls -jar 你生成的JAR包名称.jar

如果该命令能正常启动程序，就可以100%确认问题出在混打模块化JavaFX类的兼容冲突上。如果要实现双击即可运行的效果，需要调整打包逻辑，不能将JavaFX SDK类和业务类混打在同一个JAR中。

方案2：调整现有IDE Artifacts配置生成纯净业务JAR #

• 进入File->Project Structure->Artifacts，编辑你配置的名为javafx的JAR制品
• 在Output Layout配置页，将Output Root中所有来自JavaFX SDK的依赖条目全部删除，仅保留你项目的业务类（Main类、Controller类）、图片资源等自身内容
• 确认MANIFEST配置的Main-Class为sample.Main，确保所有资源加载逻辑使用相对类路径，不绑定本地绝对路径
• 重新Build Artifacts，生成仅包含业务代码的纯净JAR
• 编写简单的bat启动脚本，将带VM参数的启动命令写入脚本，双击脚本即可正常启动应用，无类加载冲突

方案3：用官方插件生成一键可运行包 #

如果不想手动维护启动脚本，可以采用JavaFX官方提供的Maven/Gradle插件，一键生成包含所有JavaFX本地依赖、配置好模块加载规则的完整可运行包，不需要手动在IDE中配置Artifacts，从根源避免混打类的兼容问题。

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