
Java模块系统(JPMS)通过module-info.java实现强封装,但未命名模块(即传统类路径加载的代码)默认可读取所有可观测模块,导致看似“绕过”了exports to限制——本文深入解析其设计原理与正确实践。
java模块系统(jpms)通过`module-info.java`实现强封装,但未命名模块(即传统类路径加载的代码)默认可读取所有可观测模块,导致看似“绕过”了`exports to`限制——本文深入解析其设计原理与正确实践。
Java 9 引入的模块化系统(JPMS)核心目标之一是实现真正的封装边界:通过 exports、requires 和 opens 等指令,精确控制哪些包对哪些模块可见。你所构建的 a 与 b 模块示例完全符合规范——module b { exports b to a; } 明确限定仅 a 模块可访问 b 包,这在模块化运行时是严格生效的。
然而,当你用以下方式编译并运行类 C:
javac -cp ".;jar/b.jar" C.java java -cp ".;jar/b.jar" C
此时 C 并未归属任何命名模块,而是被 JVM 加载到 未命名模块(unnamed module) 中。根据 JLS §7.7.5,未命名模块隐式读取(reads)所有可观测模块(observable modules),且不受 exports to 的限制。这是 JPMS 的关键兼容性设计:确保数以百万计的遗留非模块化代码(如 Spring Boot 2.x 早期应用、传统工具类、脚本式测试类)能无缝调用新模块中的公开类型,无需重写或重构。
更关键的是:b.jar 被置于类路径(-cp)而非模块路径(-p 或 --module-path)时,JVM 将其视为“自动模块(automatic module)”,而非标准命名模块。自动模块会自动导出其所有包(等效于 exports *;),且可被任何模块(包括未命名模块)访问。因此,即使 b 的 module-info.java 写着 exports b to a,当它以 JAR 形式放在 -cp 下运行时,该约束完全失效。
✅ 正确验证模块封装性的做法是:所有参与方必须统一使用模块路径,并明确归属命名模块。例如,为 C 创建独立模块 c:
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
// src/c/module-info.java
module c {
requires b; // 显式声明依赖
}
// src/c/c/C.java
package c;
import b.B;
public class C {
public static void main(String[] args) {
new B(); // ✅ 编译通过 —— 因为 c 模块 requires b,且 b 导出给 c(需修改 b 的 module-info.java)
}
}
⚠️ 注意:若坚持 exports b to a,则 c 将无法访问 B(编译报错 package b is not visible)。要使 c 也能访问,应改为 exports b;(无条件导出),或扩展为 exports b to a, c;。
? 总结要点:
-
exports X to Y是模块间白名单式访问控制,仅对命名模块有效; - 未命名模块(类路径加载)拥有“特权”,可穿透所有模块封装,这是向后兼容的必要妥协;
- 自动模块(JAR 放
-cp)放弃封装语义,自动导出全部包; - 真实模块化工程中,应统一使用
--module-path,避免混用-cp,并通过jdeps工具检测非法跨模块引用; - 生产环境推荐采用
jlink构建最小化运行时镜像,彻底排除未命名模块干扰,强化封装安全性。
模块化不是简单的“加个 module-info.java”,而是构建一套可验证、可审计、可裁剪的依赖契约体系——理解未命名模块的行为,正是掌握 JPMS 封装本质的第一课。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










