树莓派Linux环境下JavaFX Maven项目编译失败求助

错误核心分析 #

从报错信息看，两个关键问题：

• Maven未正确替换${javafx.platform}变量，导致依赖路径变为org.openjfx:javafx-controls:jar:${javafx.platform}:19-ea+9，无法匹配仓库中的实际包
• 树莓派为ARM架构，你指定的linux分类器对应x86架构的JavaFX包，Maven中央仓库中该版本的ARM架构包使用不同分类器（如linux-aarch64）

具体解决思路 #

1. 指定ARM架构专属分类器 #

修改pom.xml中的JavaFX依赖，将classifier从linux改为对应树莓派架构的分类器：

• 树莓派4及以上（64位系统）用linux-aarch64
• 32位系统用linux-arm32hf

<dependencies>
    <!-- JavaFX Controls -->
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>19-ea+9</version>
        <classifier>linux-aarch64</classifier>
    </dependency>
    <!-- JavaFX FXML -->
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-fxml</artifactId>
        <version>19-ea+9</version>
        <classifier>linux-aarch64</classifier>
    </dependency>
    <!-- 保留其他依赖 -->
</dependencies>

2. 强制清理Maven缓存并重构 #

Maven已缓存"依赖找不到"的结果，需强制更新缓存：

mvn clean install -U

3. 用JavaFX Maven插件自动适配平台 #

手动指定分类器易出错，推荐通过插件自动处理平台依赖：

• 移除所有JavaFX依赖中的classifier字段
• 完善插件配置，添加所需JavaFX模块：

<plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>0.0.8</version>
    <configuration>
        <mainClass>main.Main</mainClass>
        <modules>
            <module>javafx.controls</module>
            <module>javafx.fxml</module>
        </modules>
    </configuration>
</plugin>

4. 检查Java版本兼容性 #

pom.xml中指定的编译版本为1.9，需确保树莓派上的Java版本为Java 9或更高，且与JavaFX 19兼容（JavaFX 19要求Java 11+）。执行java -version确认版本。

5. 手动安装ARM版JavaFX（备选） #

若中央仓库无对应版本的ARM包，可手动下载OpenJFX ARM发行包，安装到本地Maven仓库：

mvn install:install-file -Dfile=javafx-controls-19-ea+9-linux-aarch64.jar -DgroupId=org.openjfx -DartifactId=javafx-controls -Dversion=19-ea+9 -Dclassifier=linux-aarch64 -Dpackaging=jar

对javafx-fxml、javafx-base等依赖重复上述命令。

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