JavaFX程序在树莓派3样式损坏报错，Windows/Kali运行正常

问题核心 #

你遇到的问题本质是架构依赖不兼容：在Kali Linux（AMD64）构建的JavaFX项目，默认拉取AMD64架构的本地.so库，但树莓派3是AARCH64（ARM64）架构，JVM无法加载跨架构的本地库，直接导致界面样式损坏和UnsatisfiedLinkError。Gdk窗口警告是库加载失败后UI渲染异常的连锁反应。

具体解决方案 #

1. 调整Maven依赖，锁定AARCH64架构 #

修改pom.xml中JavaFX相关依赖，添加linux-aarch64分类器，确保拉取ARM64版本的本地库：

<!-- JavaFX核心控件依赖 -->
<dependency>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-controls</artifactId>
    <version>你的JavaFX版本号</version>
    <classifier>linux-aarch64</classifier>
</dependency>
<!-- FXML依赖（如果用到） -->
<dependency>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-fxml</artifactId>
    <version>你的JavaFX版本号</version>
    <classifier>linux-aarch64</classifier>
</dependency>
<!-- 其他JavaFX模块（如javafx-graphics、javafx-media）同理添加classifier -->

如果用maven-javafx-plugin打包，需在插件配置里也指定架构：

<plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>maven-javafx-plugin</artifactId>
    <version>0.0.8</version>
    <configuration>
        <mainClass>你的主类全路径（如com.example.Main）</mainClass>
        <classifier>linux-aarch64</classifier>
        <!-- 可选：添加参数优化树莓派UI渲染 -->
        <options>
            <option>-Dprism.forceGPU=true</option>
        </options>
    </configuration>
</plugin>

2. 树莓派本地安装OpenJFX运行时 #

如果不想打包带依赖的jar，可直接在树莓派上安装系统级OpenJFX：

sudo apt update && sudo apt install openjfx

运行jar时指定系统库路径：

java --module-path /usr/share/openjfx/lib --add-modules javafx.controls,javafx.fxml -jar 你的程序.jar

3. 最稳妥的方式：直接在树莓派上构建 #

把代码传到树莓派，在树莓派本地用Maven编译打包，Maven会自动适配ARM64架构拉取对应依赖，从根源避免架构不匹配问题。

4. 消除Gdk窗口警告 #

库加载正常后，Gdk警告通常会自动消失。若仍存在，启动时添加缩放参数强制校准窗口：

java -Dglass.gtk.uiScale=1.0 -jar 你的程序.jar

验证流程 #

1. 按上述方式重新打包或构建项目。
2. 将jar传到树莓派，运行后检查终端是否还有UnsatisfiedLinkError。
3. 确认界面样式正常，Gdk警告是否消除。

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