Intel联想设备Gradle调试JavaFX时UnsatisfiedLinkError问题排查

1. 补全调试时的VM参数配置 #

旧版org.openjfx.javafxplugin（0.0.14）在调试场景下可能未自动传递模块路径参数，导致JVM无法定位本地库。在build.gradle中显式为所有Java执行任务添加参数：

plugins {
    id 'java'
    id 'org.openjfx.javafxplugin' version '0.0.14'
}

javafx {
    version = '20'
    modules = ['javafx.controls', 'javafx.fxml']
}

// 为运行和调试任务统一配置VM参数
tasks.withType(JavaExec) {
    jvmArgs = [
        '--module-path', classpath.asPath,
        '--add-modules', 'javafx.controls,javafx.fxml'
    ]
}

2. 检查并修复本地库的完整性与权限 #

• 首先验证报错路径下的libprism_es2.so是否存在且可读：

  ls -l /home/---/.gradle/caches/modules-2/files-2.1/org.openjfx/javafx-graphics/---/---/libprism_es2.so
  

• 若文件缺失或损坏，删除对应Gradle缓存目录后重新拉取依赖：

  rm -rf /home/---/.gradle/caches/modules-2/files-2.1/org.openjfx/javafx-graphics/
  ./gradlew clean build --refresh-dependencies
  

3. 强制使用软件渲染绕过硬件驱动问题 #

Intel核显在Fedora环境下可能存在硬件渲染兼容性问题，添加JVM参数强制JavaFX使用软件渲染：
在调试配置中追加以下参数：

-Dprism.order=sw

也可以直接写入build.gradle的jvmArgs列表：

tasks.withType(JavaExec) {
    jvmArgs = [
        '--module-path', classpath.asPath,
        '--add-modules', 'javafx.controls,javafx.fxml',
        '-Dprism.order=sw'
    ]
}

4. 升级Gradle JavaFX插件版本 #

0.0.14版本存在调试场景下的参数传递缺陷，升级至最新稳定版（如0.0.19）可自动修复此类问题：

plugins {
    id 'org.openjfx.javafxplugin' version '0.0.19'
}

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