本文详解 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 支持 的标准化流程：
新建项目 → 选择 “JavaFX” 模板 → 勾选 “Maven”
（路径：File → New Project → JavaFX → 勾选 “Use Maven”）-
确保 pom.xml 包含 JavaFX 依赖与插件（以 JDK 17+ / JavaFX 20+ 为例）：
<properties><maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target><javafx.version>22.0.1</javafx.version></properties>
```
-
保留 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 处于主流稳定版本，避免因工具链陈旧导致的隐性兼容问题。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
