在M1芯片Mac上构建的JavaFX项目Jar包无法在Windows10运行如何解决

你打包时内置的.dylib是macOS平台专属的JavaFX原生库，Windows系统无法识别调用，运行时找不到适配Windows的图形渲染相关原生组件，才会抛出QuantumRenderer初始化失败、无可用工具链的报错。
开头的Unsupported JavaFX configuration警告是因为JavaFX类被加载到了未命名模块，不属于核心报错原因，不影响功能修复。

可行修复方案 #

方案1：构建全平台通用Jar #

修改项目构建配置，同时引入多平台的JavaFX原生依赖，打包后可直接在Windows、macOS、Linux运行：

• 如果你使用Maven构建，所有用到的JavaFX组件（controls、fxml、graphics、media等）都要分别配置win、mac、linux三个平台的分类器，示例配置如下：

<dependency>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-controls</artifactId>
    <version>你的项目使用的JavaFX版本号</version>
    <classifier>win</classifier>
</dependency>
<dependency>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-controls</artifactId>
    <version>你的项目使用的JavaFX版本号</version>
    <classifier>mac</classifier>
</dependency>
<dependency>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-controls</artifactId>
    <version>你的项目使用的JavaFX版本号</version>
    <classifier>linux</classifier>
</dependency>

• 如果你使用Gradle构建，直接修改JavaFX插件配置，添加platform = ['win', 'mac', 'linux']即可。

方案2：分平台打包（包体积更小） #

如果不想因包含多平台原生库导致Jar体积过大，可以针对不同目标平台单独打包：

• 打包Windows版本时，所有JavaFX依赖仅保留win分类器
• 打包macOS版本时，仅保留mac分类器即可

方案3：打包为平台专属安装包（推荐用于对外分发） #

使用JDK自带的jpackage工具，或者badass-runtime、javafx-maven-plugin等构建插件，将应用打包为对应平台的可执行程序：

• Windows平台生成exe安装包
• macOS平台生成dmg镜像
• Linux平台生成deb/rpm安装包
  打包时会自动内置对应平台的JRE和JavaFX原生库，用户不需要额外安装Java环境即可运行，不会出现平台兼容问题，也不会暴露Jar源码。

临时验证方案 #

如果需要快速确认问题，可以让你的朋友在Windows设备上安装对应版本的JavaFX SDK，运行时指定库路径即可启动：
java --module-path "Windows上JavaFX SDK的lib目录绝对路径" --add-modules javafx.controls,javafx.fxml,javafx.graphics -jar GroupChat.jar

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