核心在于准确识别自动模块名并在module-info.java中精准requires声明：jvm将非标准命名jar转为自动模块，模块名需按规则转换（连字符/下划线→点号、去版本号、首字母开头），并用jdeps或--list-modules验证，确保大小写一致、不加引号、不混淆包名；同时必须置于模块路径而非类路径，反射访问需额外opens授权。
Java 模块化项目中处理非标准命名第三方包，核心在于让 JVM 正确识别其模块名，并在 module-info.java 中精准声明依赖。所谓“非标准命名”，主要指 JAR 文件名含连字符（-）、下划线（_）、数字开头、或与内部包名不一致等情况——这类包通常没有 module-info.class，JVM 会将其转为自动模块，但推断出的模块名可能不符合直觉，容易写错 requires 导致编译失败或运行时类找不到。
确认自动模块名的准确方式
不能凭 JAR 文件名直接猜模块名。JVM 的推断规则是：去掉版本号和 .jar 后缀，将所有连字符（-）和下划线（_）替换为点号（.），并确保首字符为字母。例如：
-
slf4j-simple-1.7.36.jar→slf4j.simple -
log4j-api-2.20.0.jar→log4j.api -
fastjson-1.2.83.jar→fastjson -
guava-31.1-jre.jar→guava.jre（注意不是com.google.common）
最可靠的方法是用工具验证：
- 运行
jdeps --list-modules your-app.jar，查找对应 JAR 的模块名 - 或解压 JAR，检查
META-INF/MANIFEST.MF是否有Automatic-Module-Name属性（部分库已手动声明） - 启动时加
--list-modules参数，观察控制台输出
正确配置 module-info.java 声明
确认模块名后，在 module-info.java 中使用该名称写 requires。注意三点：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 名称大小写必须完全一致（如
log4j.api不可写成Log4j.Api） - 不要加引号，也不要用包名（如
org.apache.logging.log4j是包名，不是模块名） - 若多个模块依赖同一自动模块，只需声明一次；重复声明不会报错但无意义
示例：
module com.example.app {
requires slf4j.simple;
requires log4j.api;
requires fastjson;
exports com.example.api;
}
避免常见路径与加载错误
即使模块名写对，仍可能因路径问题导致“类找不到”：
- 必须把非模块化 JAR 放在 模块路径（
--module-path或-p） 上，不能放在类路径（-cp）；否则它会被视为匿名模块，无法被requires引用 - Maven 用户需显式启用模块路径：
<usemodulepath>true</usemodulepath>配置到maven-compiler-plugin和maven-surefire-plugin - 运行时必须用
--module-path+--module启动，禁用-cp
反射、资源或内部类访问失败怎么办
自动模块默认导出所有包，所以普通 import 和 new 一般没问题。但以下场景需额外授权：
- 用
ObjectMapper反序列化其内部类 → 在你的模块中加opens com.example.model to com.fasterxml.jackson.databind;（目标模块名要写对） - 通过
Class.forName("xxx.Yyy")加载其类 → 确保该类所在包已被导出（自动模块已满足），但若涉及私有字段访问，仍需opens - 读取
META-INF/services/下的服务实现 → 用uses xxx.ServiceInterface;声明
如果以上都做了还报 IllegalAccessError 或 NoSuchFieldException，大概率是反射目标未被 opens，或模块路径未统一。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
