在macOS系统IntelliJ中运行JavaFX项目提示缺失运行时组件如何解决

排查步骤 #

• 确认VM参数生效范围
  IntelliJ中VM参数需要配置到当前项目对应的独立运行配置中，而非全局默认VM参数。操作路径：顶部菜单「Run」→「Edit Configurations」→ 找到当前启动JavaFX项目的配置项，将--module-path /Users/frenk/Desktop/javafx-sdk-17/lib --add-modules javafx.controls,javafx.fxml 粘贴到「VM options」输入框，确认保存后重启项目。
• 确认JavaFX SDK与环境匹配
  1. 架构匹配：若使用Apple Silicon系列芯片，需下载arm64架构的JavaFX 17 SDK，Intel芯片需下载x64架构的SDK，架构不匹配会导致运行时无法识别组件。
  2. 路径有效性：在终端执行ls /Users/frenk/Desktop/javafx-sdk-17/lib，确认路径下存在javafx.controls.jar、javafx.fxml.jar等核心库文件，执行sudo chmod -R 755 /Users/frenk/Desktop/javafx-sdk-17确保当前用户对目录有读取权限。
• 确认项目依赖配置
  打开「File」→「Project Structure」→「Libraries」，确认JavaFX的lib目录已被添加到项目依赖中，且依赖作用域（Scope）设置为「Compile」，无排除规则。
• 确认macOS安全限制
  首次运行未签名的JavaFX库时，macOS会阻止动态库加载，可打开「系统偏好设置」→「安全性与隐私」→「通用」，允许被拦截的JavaFX相关组件运行，再重启项目。

备选绕过方案 #

如果上述排查后问题仍未解决，可绕开Java模块系统限制，无需配置VM参数：

1. 在原有继承Application的启动主类同级，新建普通Java类作为启动入口，示例代码：

public class Launcher {
    public static void main(String[] args) {
        // 替换为你原有JavaFX启动主类的类名
        YourOriginalMainClass.main(args);
    }
}

2. 修改运行配置的主类为新的Launcher类，直接启动即可，该方案可规避模块系统对JavaFX运行时的检查要求。

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