module-info.java实战：解决第三方JAR变量读取难题

本文深入解析了在Java模块化（JPMS）环境下如何正确处理非模块化第三方JAR（如fastjson、commons-lang3等）的依赖与变量读取难题：关键在于将这些JAR置于模块路径而非类路径，使其被JVM自动识别为“自动模块”，并依据JAR文件名推断出准确模块名（如fastjson、log4j.core）在module-info.java中声明requires；同时针对反射访问失败、SPI加载异常或静态常量读取不到等典型问题，指出需通过opens授权包级反射、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 才会将其识别为自动模块并参与模块解析。

• 编译时：用 --module-path 替代 -cp，并把所有依赖 JAR 和自己的模块输出目录都放进去
• 运行时：同样必须用 --module-path + --module 启动，不能混用 -cp
• Maven 用户：确认 maven-compiler-plugin 和 maven-surefire-plugin 都配置了 true

需要读取内部常量或反射访问？补上 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
fastjson-1.2.83.jar -> java.desktop
说明模块名为 fastjson；若显示 fastjson.1.2.83，则需用后者。

到这里，我们也就讲完了《module-info.java实战：解决第三方JAR变量读取难题》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！