Eclipse中JavaFX项目运行报错：Graphics Device初始化失败及module-info问题

问题现象 #

运行JavaFX项目的Main.java时出现以下报错：

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/com.sun.javafx.tk.quantum.QuantumRenderer.getInstance(QuantumRenderer.java:283)
    at javafx.graphics/com.sun.javafx.tk.quantum.QuantumToolkit.init(QuantumToolkit.java:254)
    at javafx.graphics/com.sun.javafx.tk.Toolkit.getToolkit(Toolkit.java:266)
    at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:291)
    at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:163)
    at javafx.graphics/com.sun.javafx.application.LauncherImpl.startToolkit(LauncherImpl.java:659)
    at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(LauncherImpl.java:410)
    at javafx.graphics/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:1082)
Caused by: java.lang.RuntimeException: Error initializing QuantumRenderer: no suitable pipeline found
    at javafx.graphics/com.sun.javafx.tk.quantum.QuantumRenderer$PipelineRunnable.init(QuantumRenderer.java:95)
    at javafx.graphics/com.sun.javafx.tk.quantum.QuantumRenderer$PipelineRunnable.run(QuantumRenderer.java:125)
    at java.base/java.lang.Thread.run(Thread.java:833)
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:1082)
Caused by: java.lang.RuntimeException: No toolkit found
    at javafx.graphics/com.sun.javafx.tk.Toolkit.getToolkit(Toolkit.java:278)
    at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:291)
    at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:163)
    at javafx.graphics/com.sun.javafx.application.LauncherImpl.startToolkit(LauncherImpl.java:659)
    at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(LauncherImpl.java:410)
    at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplication(LauncherImpl.java:364)
    ... 5 more

同时module-info.java文件代码标红，已尝试重装Java/JavaFX、添加项目依赖库、安装GTK 2/3但未解决。

解决步骤 #

1. 修复module-info.java语法与依赖声明 #

打开module-info.java，确保代码符合模块化规范，示例如下（替换为你的项目实际名称）：

module com.example.javafxdemo {
    requires javafx.controls;
    requires javafx.fxml;
    
    opens com.example.javafxdemo to javafx.fxml;
    exports com.example.javafxdemo;
}

• 检查是否有拼写错误（比如requires写成require）
• 确保声明的模块与JavaFX SDK中包含的模块一致（核心模块为javafx.controls、javafx.fxml，根据需求添加javafx.graphics等）

2. 确认JavaFX SDK在Modulepath而非Classpath #

• 右键项目 → Build Path → Configure Build Path
• 切换到Modulepath标签，确认JavaFX SDK已添加且状态正常（无红色感叹号）
• 如果之前加在Classpath，移除后重新添加到Modulepath，模块化项目必须依赖Modulepath中的模块

3. 配置运行时VM参数 #

• 右键Main.java → Run As → Run Configurations
• 切换到Arguments标签，在VM arguments输入框中添加：

  --module-path "/path/to/javafx-sdk/lib" --add-modules javafx.controls,javafx.fxml
  

  替换/path/to/javafx-sdk/lib为你本地JavaFX SDK的lib目录绝对路径（Windows系统用\或转义\\）
• 若为Linux系统，可尝试添加强制渲染参数解决管道问题：

  --module-path "/path/to/javafx-sdk/lib" --add-modules javafx.controls,javafx.fxml -Dprism.order=sw
  

4. 验证Java与JavaFX版本兼容性 #

• 确保使用的JDK版本与JavaFX SDK版本完全匹配（比如JDK 21对应JavaFX 21）
• 打开Eclipse的Window → Preferences → Java → Installed JREs，确认默认JDK为目标版本

5. Linux系统额外依赖检查 #

• 执行以下命令安装缺失的系统依赖：

  sudo apt install libgtk-3-dev libglib2.0-dev libgstreamer-plugins-base1.0-dev
  

• 若仍有问题，在VM参数中添加native库路径：

  --module-path "/path/to/javafx-sdk/lib" --add-modules javafx.controls,javafx.fxml -Djava.library.path="/path/to/javafx-sdk/lib"
  

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