Java中default访问权限不等于“包私有”,它仅实现包级可见,无法阻止同名包下不同模块/路径的非法访问;真正封装需结合JPMS模块化(exports控制)、工厂模式隔离与构建期字节码校验三层防护。

Java 中没有真正的“包私有”访问控制机制,default(即不写 public/protected/private)访问权限只是“包级可见”,它无法阻止同包名但不同物理路径或不同模块的代码访问——这在多模块、OSGi、JPMS 或 Maven 聚合项目中极易被绕过。
为什么 default 不等于“包私有”
很多人误以为把类/方法设为 default 就能锁死访问,实际它只做两件事:不对外暴露(非 public),且允许同一运行时包(runtime package)下的所有类访问。问题在于:
- 只要另一个 JAR 或模块里也声明了
package com.example.util;,JVM 就认为它和你的类在“同一个包”——哪怕源码完全无关 - Maven 子模块若未启用
--illegal-access=deny或模块化(module-info.java),也能轻松跨模块访问default成员 - 反射可直接绕过所有访问修饰符(
setAccessible(true)),default对它毫无约束力
用 module-info.java 限制包导出
Java 9+ 的模块系统才是唯一能实现“真正包封装”的手段。仅声明 default 没用,必须配合 exports 显式控制哪些包对谁可见:
module my.internal.lib {
// 不 exports com.example.internal → 外部模块根本看不到这个包
exports com.example.api; // 只开放 API 包给所有人
exports com.example.spi to java.sql; // 仅向特定模块开放 SPI 包
}
关键点:
- 未
exports的包,即使类是public,其他模块也无法 import 或 new 实例 模块路径( - 如果依赖第三方库未模块化,需用
requires transitive或opens(慎用,破坏封装)补救
--module-path)下运行才生效;类路径(-cp)会退化为传统 classloader 行为,module-info.java 形同虚设
替代方案:用 private + 静态工厂 + 内部类隔离
当无法升级到模块化(如 JDK 8 环境),只能靠设计收敛访问入口:
- 把核心实现类设为
private或default,仅暴露public static工厂方法在顶层类中 - 工厂方法返回接口类型,而非具体类名(避免用户 new 实现类)
- 将敏感逻辑下沉到
private static final内部类,外部连反射都难定位到类名 - 在工厂方法里加
StackWalker检查调用栈(JDK 9+)或SecurityManager(已弃用,仅作警示)判断是否来自预期包
示例:
public final class ServiceFactory {
private ServiceFactory() {} // 禁止实例化
public static Service create() {
// 可选:检查调用方是否在白名单包内
String caller = StackWalker.getInstance()
.walk(s -> s.skip(1).findFirst())
.map(f -> f.getDeclaringClass().getPackage().getName())
.orElse("");
if (!caller.startsWith("com.example.trusted.")) {
throw new SecurityException("Illegal access from " + caller);
}
return new DefaultService(); // 返回 private 实现类
}
private static class DefaultService implements Service { ... }
}
构建期防护:Maven 插件 + 字节码校验
运行时控制总有漏洞,得在打包前就卡住非法引用:
- 用
maven-enforcer-plugin的banDuplicateClasses和requireUpperBoundDeps防止同包冲突 - 用
moditect-maven-plugin自动生成module-info.java并验证导出规则 - 引入
archunit-maven-plugin编写断言,例如:noClasses().that().resideInAPackage("..internal..").should().accessClassesThat().resideInAnyPackage("..api..") - CI 流程中跑
javap -v检查关键类的AccessFlags是否含ACC_PUBLIC,避免误发布
真正安全的包封装,从来不是靠一个访问修饰符,而是模块声明、工厂模式、构建校验三层叠加上运行时最小权限原则共同作用的结果。最容易被忽略的是:没启用模块路径时,module-info.java 完全不生效;而没配 archunit 规则时,团队协作中一次误提交就可能暴露整个 internal 包。










