M2 Mac（Eclipse环境）安装JavaFX遇Quantum Renderer错误求助

问题描述 #

我在M2 Mac的Eclipse环境中配置JavaFX时，反复遇到“Quantum Renderer”错误。Windows设备上已经有两个成功运行的JavaFX配置，VM参数和构建路径和Mac端完全一致。我知道下载错误架构的SDK会导致这个问题，已经下载了适配M2 MacBook的aarch64架构SDK，但还是出现问题，想知道问题出在哪里？

我的构建路径 #

我的VM参数 #

--module-path /Users/sohammukherjee/Downloads/javafx-sdk-22.0.1/lib/ --add-modules=javafx.controls

错误信息 #

Graphics Device initialization failed for :  es2, sw
Error initializing QuantumRenderer: no suitable pipeline found
java.lang.RuntimeException: java.lang.RuntimeException: Error initializing QuantumRenderer: no suitable pipeline found
    at javafx.graphics@22.0.1/com.sun.javafx.tk.quantum.QuantumRenderer.getInstance(QuantumRenderer.java:283)
    at javafx.graphics@22.0.1/com.sun.javafx.tk.quantum.QuantumToolkit.init(QuantumToolkit.java:253)
    at javafx.graphics@22.0.1/com.sun.javafx.tk.Toolkit.getToolkit(Toolkit.java:263)
    at javafx.graphics@22.0.1/com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:290)
    at javafx.graphics@22.0.1/com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:162)
    at javafx.graphics@22.0.1/com.sun.javafx.application.LauncherImpl.startToolkit(LauncherImpl.java:651)
    at javafx.graphics@22.0.1/com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(LauncherImpl.java:409)
    at javafx.graphics@22.0.1/com.sun.javafx.application.LauncherImpl.launchApplication(LauncherImpl.java:364)
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)
    at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.base/java.lang.reflect.Method.invoke(Method.java:568)
    at java.base/sun.launcher.LauncherHelper$FXHelper.main(LauncherHelper.java:1085)
Caused by: java.lang.RuntimeException: Error initializing QuantumRenderer: no suitable pipeline found
    at javafx.graphics@22.0.1/com.sun.javafx.tk.quantum.QuantumRenderer$PipelineRunnable.init(QuantumRenderer.java:95)
    at javafx.graphics@22.0.1/com.sun.javafx.tk.quantum.QuantumRenderer$PipelineRunnable.run(QuantumRenderer.java:125)
    at java.base/java.lang.Thread.run(Thread.java:840)
Exception in thread "main" java.lang.reflect.InvocationTargetException
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)
    at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.base/java.lang.reflect.Method.invoke(Method.java:568)
    at java.base/sun.launcher.LauncherHelper$FXHelper.main(LauncherHelper.java:1085)
Caused by: java.lang.RuntimeException: No toolkit found
    at javafx.graphics@22.0.1/com.sun.javafx.tk.Toolkit.getToolkit(Toolkit.java:275)
    at javafx.graphics@22.0.1/com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:290)
    at javafx.graphics@22.0.1/com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:162)
    at javafx.graphics@22.0.1/com.sun.javafx.application.LauncherImpl.startToolkit(LauncherImpl.java:651)
    at javafx.graphics@22.0.1/com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(LauncherImpl.java:409)
    at javafx.graphics@22.0.1/com.sun.javafx.application.LauncherImpl.launchApplication(LauncherImpl.java:364)
    ... 5 more

问题排查与解决方案 #

1. 确认JDK架构与JavaFX匹配 #

终端执行java -version，检查输出是否包含aarch64，确保使用的是原生Apple Silicon版JDK，而非x86_64架构通过Rosetta运行的版本。如果是x86_64，需重新下载安装Apple Silicon版JDK。

2. 修正VM参数的模块路径 #

• 检查/Users/sohammukherjee/Downloads/javafx-sdk-22.0.1/lib/路径下是否存在javafx.graphics相关的.jar和.dylib原生库文件。
• 尝试去掉路径末尾的斜杠，改为/Users/sohammukherjee/Downloads/javafx-sdk-22.0.1/lib，避免路径识别问题。

3. 补充缺失的核心模块 #

当前VM参数仅添加了javafx.controls，但渲染核心javafx.graphics需要显式引入。修改VM参数为：

--module-path /Users/sohammukherjee/Downloads/javafx-sdk-22.0.1/lib --add-modules=javafx.controls,javafx.graphics

根据项目需求，还可添加javafx.fxml等其他必要模块。

4. 确认运行配置的VM参数生效 #

确保VM参数是在项目的Run Configurations中设置的，而非仅在Eclipse全局偏好里配置。项目级配置会覆盖全局设置，需检查对应运行项的VM参数是否正确。

5. 重新验证JavaFX SDK完整性 #

重新下载aarch64版本的JavaFX SDK，解压后确认lib目录下的原生库（如libprism_es2.dylib、libquantum.dylib）存在且未损坏。

6. 强制使用软件渲染 #

若以上方法无效，可在VM参数中添加强制软件渲染属性，绕过硬件渲染问题：

--module-path /Users/sohammukherjee/Downloads/javafx-sdk-22.0.1/lib --add-modules=javafx.controls -Dprism.order=sw

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