module-info.java是封装边界声明工具,非加密鉴权机制;通过精准exports/opens控制可见性与反射权限,配合requires约束依赖传递,并借助JVM参数强化运行时封装验证。

module-info.java 不是“增强安全”的开关,而是封装边界的声明工具。它本身不加密、不鉴权,但能从架构层面减少意外暴露和非法访问——关键在于精准控制“谁能看到什么”“谁能在运行时动什么”。
只导出真正需要的包
未被 exports 的包,外部模块连 public 类都无法引用。这是最基础也最有效的隔离手段。
- 避免写
exports com.example.*;这类通配导出,逐个明确导出接口包(如exports com.example.api;) - 内部实现包(如
com.example.internal)绝不导出,哪怕类是 public - 若某包仅需被特定模块使用,用
exports com.example.spi to com.vendor.plugin;限定接收方
谨慎开放反射权限
opens 指令是反射访问的唯一合法入口,滥用等于主动开后门。
- 不要写
opens com.example.util;(对所有模块开放),这会让任意模块通过反射修改私有字段 - 框架依赖反射时(如序列化、ORM),只定向开放:
opens com.example.model to java.xml.bind; - 完全不需要反射的模块,module-info 中不出现
opens指令
约束依赖传递与运行时可见性
依赖声明不当会间接扩大攻击面,比如让恶意模块借道获得本不该有的访问权。
- 避免无脑加
requires transitive,除非你确认下游模块必须继承该依赖的导出能力 - 对仅编译期需要的模块(如注解处理器),用
requires static javax.annotation;,运行时不可见 - 检查 JDK 自带模块(如
java.desktop)是否真被用到,不必要的依赖会增加攻击表面积
配合 JVM 参数做运行时兜底
开发阶段可借助 JVM 参数验证封装强度,防止上线后因疏漏导致越权访问。
- 启动时加
--illegal-access=deny,强制拦截非法反射调用(Java 16+ 默认启用) - 临时调试可用
--add-exports或--add-opens,但禁止将其写入生产启动脚本 - 结合
jdeps --list-deps分析实际依赖链,识别隐式依赖带来的潜在暴露点










