NetBeans模块依赖错误求助：org.openide.util未被命名模块读取

一、模块依赖解析问题 #

• 核对pom.xml中org-openide-util的依赖配置：确认依赖的scope不是provided或test，版本和同类正常项目完全一致，直接对比正常项目的pom依赖片段，排除版本或scope差异。
• 检查org-openide-util的jar是否为模块化jar：找到本地Maven仓库中该依赖的jar包，解压后查看根目录是否存在module-info.class。如果没有，说明这是非模块化jar，只能放在类路径（未命名模块），无法通过requires直接声明引用。
• 确认自定义模块的可用性：对于com.customcode.common、com.customcode.myplan这两个自定义模块，先确保它们已执行mvn install安装到本地仓库，且当前项目的pom中已添加正确的groupId、artifactId、版本依赖。

二、模块路径与类路径冲突排查 #

• 查看NetBeans项目编译/运行配置：进入项目属性→构建→运行，检查VM选项中是否有--module-path或--class-path的手动配置，排查路径错误或重复依赖。
• 生成Maven依赖树：在项目根目录执行mvn dependency:tree，输出所有依赖的层级关系，检查是否存在org-openide-util的版本冲突，或依赖被意外排除（比如<exclusions>配置）。
• 处理模块化与非模块化依赖混合场景：如果org-openide-util是非模块化jar，注释requires org.openide.util;后，需在module-info.java中添加requires static org.openide.util;（若为编译时依赖），或在VM选项中加入--add-reads com.customcode.spm=ALL-UNNAMED，让当前模块读取未命名模块的内容。

三、未命名模块相关操作 #

• 查看依赖所在路径：在NetBeans中右键项目→构建→编译，查看“编译类路径”和“模块路径”，确认org-openide-util是在类路径（未命名模块）还是模块路径（自动/显式模块）。
• 控制未命名模块访问：若需让模块化项目访问未命名模块的依赖，可添加VM参数--add-reads com.customcode.spm=ALL-UNNAMED（com.customcode.spm为当前模块名），或用--add-modules ALL-DEFAULT,ALL-UNNAMED强制包含未命名模块。
• 禁用未命名模块隔离：如果不需要模块化特性，可直接删除module-info.java，并检查Maven编译插件是否移除了模块化相关配置，让项目完全回到类路径模式。

四、NetBeans特定配置排查 #

• 重置项目配置：备份项目根目录下的nbproject文件夹后删除，重新导入项目，让NetBeans生成全新配置，排除旧配置干扰。
• 检查NetBeans模块系统设置：进入工具→选项→Java→模块，确认“启用模块系统”选项勾选状态，以及模块路径默认配置是否正常。
• 查看详细编译日志：在NetBeans输出窗口切换到“编译”标签，查看完整编译命令和错误细节，排查是否有NetBeans自动添加的模块参数错误。

底层机制参考文档 #

• NetBeans 15 Java模块支持文档：重点关注模块化项目的构建流程、依赖解析逻辑，以及NetBeans对模块路径与类路径的优先级处理规则。
• Java 15模块系统官方文档：深入理解自动模块、未命名模块的概念，掌握requires、requires static、--add-reads、--add-modules等参数的作用，以及模块化项目与非模块化依赖的交互规则。
• Maven模块化项目配置文档：查看maven-compiler-plugin和maven-surefire-plugin在模块化项目中的配置说明，了解Maven如何管理模块路径与类路径。

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