运行Eclipse导出的JavaFX可执行jar报UnsatisfiedLinkError如何解决

报错原因 #

• 核心原因是命令行参数顺序错误：Java 命令执行逻辑中，所有JVM参数、模块配置参数必须放在-jar或主类名之前，放在jar包后的参数会被识别为应用程序入参，不会被JVM生效处理。你原命令中将--module-path、--add-modules放在main.jar之后，JavaFX模块配置未生效，导致本地库加载失败。
• 额外触发原因：你使用Eclipse默认的「将依赖库打包进jar」导出选项时，会使用Eclipse自定义的rsrc:资源协议加载内部依赖，JavaFX的原生库加载器不识别该协议，无法定位到javafx.graphics模块对应的本地库文件，最终抛出链接错误。

解决方案 #

1. 修正命令行参数顺序，正确的运行命令如下：

java -Djavafx.verbose=true --module-path /users/home/javafx-sdk-11.0.2/lib --add-modules javafx.controls,javafx.fxml -jar main.jar

2. 重新导出jar包：Eclipse导出可运行jar时，选择「Extract required libraries into generated JAR」（将依赖解压后打包进jar），避免使用rsrc:协议的类加载器。如果需要给无JavaFX环境的朋友使用，建议使用jlink工具将JRE、JavaFX模块和应用一起打包为可执行镜像，无需额外配置运行环境。

报错原因 #

这是JavaFX的线程规则限制：所有JavaFX UI相关操作（包括窗口初始化、控件属性修改、FXML加载、界面渲染等），必须在JavaFX专属的「FX Application Thread（事件线程）」上执行。你调整参数顺序后模块配置生效、程序可以正常启动，但你的代码中直接在main方法（主线程）执行了UI操作，触发了JavaFX的线程校验，因此抛出该异常。

解决方案 #

根据你的代码结构二选一即可：

1. 标准JavaFX项目结构：如果你的主类继承了javafx.application.Application，不要在main方法中写任何UI逻辑，将窗口初始化、FXML加载等逻辑全部放在Application类的start(Stage primaryStage)方法中，main方法仅保留launch()启动代码即可，launch()方法会自动将start()的逻辑投递到事件线程执行。
2. 非标准结构/跨线程UI操作：如果确实需要在主线程或其他业务线程中执行UI操作，使用Platform.runLater()方法包裹UI逻辑，示例如下：

import javafx.application.Platform;

// 其他逻辑...
Platform.runLater(() -> {
    // 此处写入所有需要执行的UI操作代码
});

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