模块路径与类路径区别，JDK 11依赖管理新规解析

Java 9引入的模块系统彻底改变了JAR依赖的加载逻辑：是否包含`module-info.class`是决定其必须放入`--module-path`还是`-cp`的唯一关键，混用将导致类找不到、模块解析失败甚至静默的访问异常；自动模块、split package、平台模块遗漏、IDE配置陷阱及Maven编译配置缺失等常见问题，往往在生产环境冷路径中突然爆发，唯有从编译、打包到运行全程严格对齐模块契约，才能真正发挥JPMS的强封装与可靠依赖管理优势。

模块路径和类路径，到底该往哪放JAR？

Java 9+ 启动时，--module-path 和 -cp（或 --class-path）不是“可互换的两个选项”，而是两套不兼容的加载逻辑。放错位置，轻则类找不到，重则模块解析失败、NoClassDefFoundError 或 IllegalAccessError 静默出现。

关键判断只有一条：这个JAR里有没有 module-info.class？

• 有 → 必须走 --module-path，否则它会被当成普通JAR，“模块声明完全失效”
• 没有 → 只能走 -cp；若硬塞进 --module-path，JVM会把它当作“自动模块”（automatic module），名字默认是 JAR 文件名（如 guava-31.1-jre.jar → 模块名 guava.31.1.jre），但包无封装、无 requires 约束，容易引发 split package 错误
• 混合项目（部分模块化、部分非模块化）→ 两者必须同时存在，且不能交叉混用：模块路径里的东西，类路径里的代码默认看不到；反之亦然

运行时报 Module not found 或 Unable to derive module descriptor 怎么办？

这是模块路径配置最典型的报错，本质是 JVM 在 --module-path 下找到了 JAR，但无法识别其模块身份。

• Unable to derive module descriptor：JAR 里没 module-info.class，又没显式指定模块名（比如用 --module-path lib/foo.jar --add-modules foo 但没配 --module-version 或自动推导失败）
• Module not found: xxx：你写了 requires xxx;，但 xxx 没出现在 --module-path 中；注意，它不会从 -cp 里找
• 常见漏点：忘了把 java.base 以外的平台模块（如 java.logging）也加到 --add-modules，尤其在自定义最小运行镜像时

实操建议：用 jar -f your-module.jar | grep module-info 确认是否存在；再用 java --list-modules | grep xxx 看目标模块是否已加载。

为什么 -cp 里放了模块化 JAR，Class.forName("xxx.Yyy") 却能成功？

因为类路径加载器（AppClassLoader）根本不管 module-info.class —— 它只按传统方式扫描 .class 文件。所以即使你把 spring-core-6.2.0.jar（含 module-info.class）扔进 -cp，Class.forName 仍能加载其中任意 public 类，但所有模块语义（exports、opens、requires）全部失效。

• 后果是：你无法用 ModuleLayer 控制模块图，反射访问受限包会抛 IllegalAccessException，JPMS 的强封装形同虚设
• 更隐蔽的问题：如果同一类在 -cp 和 --module-path 中都存在（比如两个版本的 commons-lang3），--module-path 优先，-cp 的那个被彻底忽略——但编译期可能还引用着旧版 API

IDE（如 Eclipse/IntelliJ）里勾选 “Add to Modulepath” 就万事大吉了？

不。IDE 的图形化操作只是帮你生成启动参数，真正起作用的是最终传给 JVM 的命令行。很多 IDE 默认仍以类路径模式运行，尤其当你没写 module-info.java 或项目 SDK 设为 Java 8 时，Modulepath 标签页甚至不会显示。

• Eclipse：右键项目 → Build Path → Configure Build Path → Libraries → Add External JARs → 默认加到 Classpath；要加到模块路径，得手动切换到 Modulepath 选项卡（仅当项目启用了模块支持才可见）
• IntelliJ：Project Structure → Modules → Dependencies → Scope 列选择 Runtime 不代表就是模块路径；必须勾选 Use module path 并确保 module-info.java 存在且无语法错误
• 最容易被忽略的一点：Maven 构建时，maven-compiler-plugin 需显式配置 11 或 11，否则 javac 不会处理 module-info.java

模块系统不是开关，而是一套需要贯穿编译、打包、运行三阶段的契约。少一个环节对齐，就可能在生产环境突然崩出 ClassNotFoundException —— 而且往往发生在你没测过的冷路径上。

以上就是《模块路径与类路径区别，JDK 11依赖管理新规解析》的详细内容，更多关于的资料请关注golang学习网公众号！