本文详解 intellij idea 运行 javafx 模块化项目时出现 “module not found” 或 “error occurred during initialization of boot layer” 的根本原因与系统性解决方法，涵盖项目结构、模块路径配置、构建工具集成及版本兼容性要点。

本文详解 intellij idea 运行 javafx 模块化项目时出现 “module not found” 或 “error occurred during initialization of boot layer” 的根本原因与系统性解决方法，涵盖项目结构、模块路径配置、构建工具集成及版本兼容性要点。

在使用 IntelliJ IDEA 开发模块化 JavaFX 应用时，常见报错如下：

Error occurred during initialization of boot layer
java.lang.module.FindException: Module com.example.test not found
Process finished with exit code 1

该错误表明 JVM 启动时无法定位并加载声明在 module-info.java 中的模块（如 module com.example.test { ... }），本质是模块路径（--module-path）未正确配置或模块未被识别为可解析模块，而非简单的类路径问题。

✅ 正确做法：使用 Maven + 官方 JavaFX 插件创建标准模块化项目

手动配置模块路径（如在 VM Options 中硬编码 --module-path）易出错且不可持续。推荐采用 Maven 构建 + IntelliJ 官方 JavaFX 支持 的标准化流程：

1. 新建项目 → 选择 “JavaFX” 模板 → 勾选 “Maven”
   （路径：File → New Project → JavaFX → 勾选 “Use Maven”）

2. 确保 pom.xml 包含 JavaFX 依赖与插件（以 JDK 17+ / JavaFX 20+ 为例）：

   

   Alibabacloud Sdk Client Initialization For Java

   在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

   下载

   立即学习“Java免费学习笔记（深入）”；

   <properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
    <javafx.version>22.0.1</javafx.version>
   </properties>

org.openjfxjavafx-controls${javafx.version}org.openjfxjavafx-fxml${javafx.version}org.apache.maven.pluginsmaven-compiler-plugin3.11.01717org.apache.maven.pluginsmaven-surefire-plugin3.2.5 ```

3. 保留 module-info.java，但需确保位置正确：
   必须位于 src/main/java 根目录下（即与 com/example/test/ 同级），内容示例如下：

   module com.example.test {
    requires javafx.controls;
    requires javafx.fxml;
    requires java.desktop;
   
    opens com.example.test to javafx.fxml;
    exports com.example.test;
   }

⚠️ 关键注意事项

• JDK 版本必须匹配 JavaFX：JDK 17+ 不再内置 JavaFX，需显式引入 OpenJFX 依赖；JDK 8–16 内置 JavaFX，但不支持模块系统（module-info.java 将导致编译失败）。
• IDE 版本需 ≥ 2022.3：早期 IntelliJ（如 2021.x）对 JPMS（Java Platform Module System）支持不完善，可能忽略 module-info.java 或错误解析模块路径。
• 禁止手动在 Run Configuration 中添加 --module-path：Maven 插件会自动将 JavaFX JARs 注入模块路径；手动指定易引发路径冲突或重复。
• 检查 Project Structure → Project Settings → Project → Project SDK 和 Language Level：必须设为 JDK 17+，Language level ≥ 17。

? 验证是否生效

运行主类（含 main() 方法）后，在终端中观察 JVM 启动参数，应包含类似：

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

若未出现，说明 Maven 配置未被 IDEA 正确读取——此时请右键项目 → Reload project，或点击 Maven 工具窗口中的刷新按钮。

✅ 总结

该错误不是代码缺陷，而是开发环境与模块系统集成失配所致。唯一健壮解法是放弃纯“空项目 + 手动配置”，转而使用 IntelliJ 内置的 JavaFX + Maven 向导创建项目。它自动处理模块路径、编译选项、运行时参数和依赖传递，从根本上规避 FindException。同时，请保持 IDE、Maven 和 JDK 处于主流稳定版本，避免因工具链陈旧导致的隐性兼容问题。