可行,但需将非模块化jar放模块路径使其转为自动模块,按推断名(如fastjson)声明requires,并用--module-path编译运行;反射访问需opens,spi需uses,命名模糊时用jdeps验证。

直接在 module-info.java 中声明对非模块化 JAR 的依赖是可行的,但关键不在“写进去”,而在于理解 JVM 如何推断其模块名、如何确保它被正确加载到模块路径,以及如何应对反射、资源读取或内部类访问等常见变量读取失败场景。
非模块化 JAR 会被自动转为“自动模块”
当一个不含 module-info.class 的 JAR(如老版本的 fastjson-1.2.83.jar 或 commons-lang3-3.12.0.jar)被放在 模块路径(--module-path) 上时,JVM 会为其生成一个“自动模块”(Automatic Module),名称通常来自 JAR 文件名(去掉版本号和扩展名):
-
fastjson-1.2.83.jar→ 模块名fastjson -
guava-31.1-jre.jar→ 模块名guava -
log4j-core-2.20.0.jar→ 模块名log4j.core(含点号,注意大小写)
你可以在 requires 中直接使用这个推断名,例如:
module com.example.app {
requires fastjson;
requires log4j.core;
exports com.example.api;
}
变量读取失败?大概率是模块路径没配对
很多“读不到静态变量”“Class.forName 找不到类”“Properties.load 失败”等问题,并非代码逻辑错误,而是因为该 JAR 被误放在了 类路径(-cp) 而非 模块路径(--module-path)。只有放在模块路径上,JVM 才会将其识别为自动模块并参与模块解析。
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 编译时:用
--module-path替代-cp,并把所有依赖 JAR 和自己的模块输出目录都放进去 - 运行时:同样必须用
--module-path+--module启动,不能混用-cp - Maven 用户:确认
maven-compiler-plugin和maven-surefire-plugin都配置了<usemodulepath>true</usemodulepath>
需要读取内部常量或反射访问?补上 opens 或 uses 声明
自动模块默认不导出任何包,也不允许其他模块通过反射访问其类型——这会导致 IllegalAccessException 或 NoSuchFieldException。若你的代码需读取第三方库中的 public static final String VERSION,或用 ObjectMapper 反序列化其内部类,需显式授权:
- 若要反射访问某个包下的类(如
com.alibaba.fastjson.parser.DefaultJSONParser),在你的模块中加:opens com.alibaba.fastjson.parser to com.example.app; - 若依赖服务提供者机制(SPI),比如日志框架,需声明:
uses org.slf4j.spi.SLF4JServiceProvider; - 若只是读 public static 字段,且该字段所在类在已导出包内(如
org.apache.commons.lang3.StringUtils.EMPTY),通常无需额外操作——前提是commons.lang3的包确实被导出了(它作为自动模块默认不导出,但 JVM 允许访问 public 类型的 public 成员)
不确定模块名?用 jdeps 快速验证
遇到命名模糊(如带下划线、多版本号、大小写混乱)时,别猜。用 JDK 自带工具确认实际推断名:
jdeps --list-deps --module-path libs/ your-app.jar
或针对单个 JAR:
jdeps -s libs/fastjson-1.2.83.jar
输出类似:
fastjson-1.2.83.jar -> java.base<br>fastjson-1.2.83.jar -> java.desktop
说明模块名为
fastjson;若显示 fastjson.1.2.83,则需用后者。Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










