Java项目启动报错：QuantumRenderer初始化失败及JavaFX配置警告排查

核心问题 #

你的错误和警告源于两处Gradle配置缺陷：

1. 手动添加的JavaFX Graphics依赖与javafxplugin自动管理的依赖冲突，导致JavaFX类被加载到未命名模块，违反了JavaFX的模块化加载要求。
2. 老旧的javafxplugin版本（0.0.9）对Java 17兼容性不足，无法正确处理模块化依赖和跨平台适配。

修复步骤 #

修改build.gradle文件，按以下调整执行：

1. 升级javafxplugin版本

将插件版本替换为适配Java 17的稳定版（如0.0.15）：

plugins {
    id 'application'
    id 'org.openjfx.javafxplugin' version '0.0.15'
}

2. 移除手动添加的JavaFX Graphics依赖

删除dependencies块中的以下行：

implementation 'org.openjfx:javafx-graphics:17:mac'

javafxplugin会根据你在javafx块中配置的modules（javafx.controls）自动引入所有必要依赖（包括javafx-graphics），并自动适配当前操作系统，手动添加特定平台依赖会引发冲突。

3. 配置主类（必选）

application插件需要明确主类路径，在文件末尾添加：

mainClassName = '你的主类全路径' // 示例：com.university.project.Main

最终完整配置

plugins {
    id 'application'
    id 'org.openjfx.javafxplugin' version '0.0.15'
}

apply plugin: 'java'
sourceCompatibility = 17
version = '1.0.0'
compileJava.options.encoding = 'UTF-8'

repositories {
    mavenCentral()
}

javafx {
    version = "17"
    modules = ['javafx.controls']
}

dependencies {
    implementation 'org.json:json:20220924'
    implementation 'org.apache.commons:commons-lang3:3.12.0'
}

sourceSets {
    main {
        java {
            srcDir 'src'
        }
    }
    test {
        java {
            srcDirs = []
        }
    }
}

mainClassName = '你的主类全路径'

验证修复 #

1. 清理旧构建缓存：执行命令./gradlew clean（macOS/Linux）或gradlew clean（Windows）。
2. 重新构建运行：执行./gradlew run或gradlew run。

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