解决 Maven 构建失败：模块未找到（JavaFX 项目）

“本文旨在解决在 Maven 构建 JavaFX 项目时遇到的 “module not found” 错误。该错误通常发生在项目无法找到 JavaFX 模块（如 javafx.base, javafx.controls, javafx.fxml, javafx.graphics）或第三方库（如 org.apache.poi.poi）时。本文将指导你检查 pom.xml 文件中的依赖配置，并确保 Maven 正确解析这些依赖，从而成功构建项目。”

在 Maven 项目中，遇到 “module not found” 错误，尤其是在使用 JavaFX 时，通常是由于 Maven 没有正确解析项目依赖所致。以下步骤将帮助你诊断并解决这个问题。

1. 确认 pom.xml 中的 JavaFX 依赖

首先，确保你的 pom.xml 文件中包含了所有必需的 JavaFX 依赖。检查以下几点：

• 依赖项是否完整： 确保包含了 javafx-controls, javafx-fxml, javafx-graphics, javafx-base 等所有需要的 JavaFX 模块。
• 版本号是否匹配： 确认 JavaFX 依赖的版本号与你本地安装的 JavaFX SDK 版本一致。如果不一致，可能会导致模块无法找到。
• 依赖项定义是否正确： 仔细检查 , , 和 是否正确无误。

以下是一个 pom.xml 中 JavaFX 依赖的示例：

<dependencies>     <dependency>         <groupId>org.openjfx</groupId>         <artifactId>javafx-controls</artifactId>         <version>19</version>     </dependency>     <dependency>         <groupId>org.openjfx</groupId>         <artifactId>javafx-fxml</artifactId>         <version>19</version>     </dependency>     <dependency>         <groupId>org.openjfx</groupId>         <artifactId>javafx-graphics</artifactId>         <version>19</version>     </dependency>     <dependency>         <groupId>org.openjfx</groupId>         <artifactId>javafx-base</artifactId>         <version>19</version>     </dependency> </dependencies>

注意： 将 version 替换为你实际使用的 JavaFX 版本。

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

2. 检查 module-info.java 文件

module-info.java 文件定义了模块的依赖关系。确保该文件中声明了所有需要的模块。

• requires 语句： 检查 requires 语句是否包含了所有用到的 JavaFX 模块和其他第三方库。
• transitive 关键字： 如果一个模块需要另一个模块的传递依赖，可以使用 transitive 关键字。
• opens 语句： 如果需要使用反射访问模块的私有成员，需要使用 opens 语句。

以下是一个 module-info.java 文件的示例：

module HauserProgram {     requires javafx.controls;     requires javafx.fxml;     requires javafx.graphics;     requires javafx.base;     requires java.sql;     requires org.apache.poi.poi;      opens de.hauserwein to javafx.fxml; }

3. 清理并重新构建 Maven 项目

在确认 pom.xml 和 module-info.java 文件配置正确后，尝试清理并重新构建 Maven 项目。

1. 清理项目： 在命令行或 IDE 中运行 mvn clean 命令。这将删除 target 目录，清除之前的构建结果。
2. 安装依赖： 运行 mvn install 命令。这将下载所有声明的依赖项，并将项目安装到本地 Maven 仓库。

通过执行 mvn clean install，Maven 会强制重新解析项目依赖，确保所有需要的模块都被正确加载。

4. 检查 IDE 的构建路径

有些情况下，即使 Maven 配置正确，IDE 的构建路径也可能存在问题。

• Eclipse： 确保 JavaFX SDK 已经添加到 Eclipse 的构建路径中。可以在 “Project” -> “Properties” -> “Java Build Path” -> “Libraries” 中添加。
• IntelliJ IDEA： 检查 “File” -> “Project Structure” -> “Modules” -> “Dependencies” 中是否包含了 JavaFX SDK。

5. 避免使用 org.openjfx 作为 GroupId

除非你是 JavaFX 官方团队的成员，否则不建议使用 org.openjfx 作为你项目的 groupId。这可能会引起混淆，并导致不必要的麻烦。选择一个更具描述性的 groupId，例如 com.example 或 de.yourcompany。

总结

解决 Maven 构建失败 “module not found” 错误的关键在于：

1. 仔细检查 pom.xml 文件，确保所有依赖项都已正确声明，并且版本号匹配。
2. 检查 module-info.java 文件，确保所有需要的模块都已使用 requires 语句声明。
3. 使用 mvn clean install 命令清理并重新构建项目。
4. 检查 IDE 的构建路径，确保 JavaFX SDK 已正确添加到项目中。
5. 避免使用 org.openjfx 作为你项目的 groupId。

通过遵循这些步骤，你应该能够解决 Maven 构建失败的问题，并成功构建你的 JavaFX 项目。