Linux环境下IntelliJ运行JavaFX项目提示No toolkit found问题

问题背景 #

• 技术栈：JavaFX + GraalVM，开发类Postman的UI项目，引入RichTextFX依赖实现JSON语法着色
• 异常表现：Linux系统的IntelliJ IDEA中直接运行项目时，抛出No toolkit found错误
• 正常场景：通过Maven命令mvn javafx:run可正常启动UI
• 已操作：尝试常规解决方案无效，已向JetBrains提交问题工单

针对性排查与修复建议 #

即便你试过常规方案，仍可检查以下几点：

• 确认IDE的JDK配置：打开File → Project Structure，检查项目SDK是否为GraalVM，且JavaFX模块已正确添加到依赖库中。IntelliJ有时会默认使用系统JDK而非项目指定的GraalVM，导致JavaFX toolkit无法加载
• 手动配置VM启动参数：在IntelliJ运行配置中，添加JavaFX必备的启动参数：

  --module-path /你的JavaFX SDK路径/lib --add-modules javafx.controls,javafx.fxml
  

  路径需指向你项目使用的JavaFX SDK，模块列表根据项目需求补充（比如RichTextFX依赖javafx.controls）
• 验证环境变量一致性：在IntelliJ的Terminal中执行echo $JAVA_HOME，确认输出为GraalVM的安装路径，避免IDE读取到错误的JDK环境
• 清理IDE缓存：执行File → Invalidate Caches... → Invalidate and Restart，缓存损坏可能导致启动配置异常
• 检查依赖版本兼容性：通过mvn dependency:tree查看依赖树，确保RichTextFX版本与JavaFX版本匹配（例如JavaFX 17对应RichTextFX 0.10.9及以上版本）

临时替代方案 #

在JetBrains修复该问题前，可通过以下方式启动项目：

• 继续使用mvn javafx:run命令
• 在IntelliJ中创建Maven运行配置：Run → Edit Configurations → + → Maven，目标填写javafx:run，直接通过IDE触发Maven启动流程

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