为何多数Maven项目未显式使用Java模块？Maven如何识别依赖模块？

一、未显式编写module-info.java时的依赖处理逻辑 #

当你没有编写module-info.java时，你的代码会被归类为未命名模块（unnamed module），这是Java模块系统为兼容旧代码设计的核心兼容机制：

• 未命名模块会自动读取类路径（classpath）上的所有JAR包与类，同时隐式依赖所有系统模块（比如java.sql、java.base），不需要手动添加requires java.sql;这类声明。
• Maven的处理逻辑：
  • 针对Java 9+版本的项目，Maven会根据JDK版本默认以未命名模块的方式加载类路径依赖；
  • 如果项目依赖的JAR本身是模块化JAR（自带module-info.java），Maven会自动将其纳入模块路径（module path），这就是部分项目出现“Module Dependencies”的原因——这类项目依赖了模块化的第三方库，或是Spring Boot的打包逻辑触发了模块路径的使用；
  • 纯非模块化项目（所有依赖都是传统无模块声明的JAR），Maven会沿用类路径加载逻辑，不会显示模块依赖。

二、Eclipse无法解析java.sql.*导入的原因与解决 #

即便“Module Dependencies”中已列出java.sql，仍出现解析问题，通常是以下幕后原因：

• 未命名模块隐式依赖失效：Eclipse的模块兼容逻辑偶尔会出现缓存异常，导致系统模块的索引未正确更新。
• 路径配置冲突：项目同时混合模块路径与类路径配置时，Eclipse可能无法正确识别未命名模块对系统模块的隐式依赖。
• JDK配置异常：项目绑定的JDK可能未完整加载系统模块，比如JDK安装目录损坏，或是Eclipse的JRE配置仅指向了JRE而非完整JDK。

对应的解决步骤：

• 右键项目 → Maven → Update Project，勾选“Force Update of Snapshots/Releases”，重新同步依赖与模块配置。
• 检查JRE系统库：右键项目 → Build Path → Configure Build Path，确保选中Java 9+版本的完整JDK，而非仅JRE，点击“Edit”确认JDK路径无误。
• 重置Eclipse模块缓存：打开Window → Preferences → Java → Build Path → Classpath Variables，检查JRE_LIB等变量指向的JDK模块目录是否正确；或直接删除项目的.settings文件夹与.project文件，重新导入Maven项目。

三、Spring Boot项目的模块差异说明 #

Spring Boot对模块系统的处理较为特殊：2.x及以上版本默认支持模块系统，但为兼容大量非模块化第三方依赖，默认会将项目打包为未命名模块。只有当你显式添加module-info.java，或是依赖的库本身是模块化的，才会触发模块路径的使用，这也是你看到部分项目有“Module Dependencies”的差异原因。

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