Java常用反射类库与Constructor

苏承栈

2026-09-12 • 👁 0人浏览过

Constructor获取私有构造器需用getDeclaredConstructor()而非getConstructor()，调用前必须setAccessible(true)，否则newInstance()抛IllegalAccessException；JDK12+需注意模块化限制。如何用

Constructor

获取并调用私有构造方法 Java 反射中，

Constructor

是操作类构造器的核心类型。默认只能获取 public 构造器；要调用 private 构造器（比如单例、测试绕过初始化），必须显式设置可访问性。先用

clazz.getDeclaredConstructor(paramTypes...)

获取目标构造器，不能用

getConstructor()

（它只查 public）立即调用

constructor.setAccessible(true)

，否则

newInstance()

会抛

IllegalAccessException

注意：JDK 12+ 在强封装模式下（如模块化环境），

setAccessible(true)

可能被 SecurityManager 拦截或触发警告，需配合 JVM 参数

--add-opens java.base/java.lang=ALL-UNNAMED

Class clazz = Class.forName("com.example.User");
Constructor ctor = clazz.getDeclaredConstructor(String.class, int.class);
ctor.setAccessible(true);
Object instance = ctor.newInstance("Alice", 25);

getDeclaredConstructors()

和

getConstructors()

的关键区别二者返回数组类型相同，但可见性策略完全不同，直接影响能否覆盖全部构造场景。

getConstructors()

：仅返回当前类中 public 的构造方法，不包含父类的，也不含 protected/package-private/private

getDeclaredConstructors()

：返回当前类声明的所有构造器（无论修饰符），但不递归查找父类；若需完整构造链，得手动向上遍历

getSuperclass()

性能上无显著差异，但误用

getConstructors()

查 private 构造器会导致空数组，进而引发

ArrayIndexOutOfBoundsException

或

NullPointerException

用

Constructor

创建对象时的常见异常与规避方式反射实例化比 new 更易出错，多数异常源于参数匹配或权限控制，而非逻辑错误。

NoSuchMethodException

：参数类型未精确匹配——例如传

int.class

却试图匹配

Integer.class

；解决办法是用

Integer.TYPE

对应基本类型，或统一用包装类 +

getDeclaredConstructor(Object.class)

配合自动装箱（不推荐，不可靠）

InstantiationException

：类是接口、抽象类或没有合适构造器；检查

clazz.isInterface()

或

clazz.isPrimitive()

InvocationTargetException

：构造器内部抛出异常（如 NPE、校验失败）；其

getCause()

才是真实错误源，必须解包查看为什么 Spring 和 Jackson 不直接用

Constructor.newInstance()

现代框架普遍弃用已废弃的

Constructor.newInstance()

（JDK 9 标记为 deprecated），改用更底层、更可控的方式。 elasticsearch-9.4.0 win PHP中文网提供Elasticsearch 9.4.0 Windows 版本压缩包下载解压即用，内置 OpenJDK 无需额外配置 Java 环境。该版本重磅推出原生 Prometheus 支持、正式版 Elastic Workflows 以及基于 NVIDIA cuVS 的 GPU 加速向量索引，大幅提升 AI 检索与可观测性能力。建议前往官网下载，快速体验极速搜索与强大的数据分析功能。下载立即学习 “ Java免费学习笔记（深入） ”； JDK 9 起，该方法被标记为废弃，因它会额外包装异常（把构造器内抛的

RuntimeException

包成

InvocationTargetException

），增加调试成本主流方案转向

Unsafe.allocateInstance(clazz)

（跳过构造器执行，适用于无参且无需初始化字段的场景），或使用字节码生成（如 CGLIB）动态构造代理类如果你在写工具类，也建议封装一层：对无参构造优先用

getDeclaredConstructor().newInstance()

，有参则严格校验类型并捕获

InvocationTargetException

后 rethrow

getCause()

真正难的不是调用构造器，而是判断该不该调、用哪个构造器、以及怎么让异常链不丢失原始上下文——这些细节在日志里往往只显示一行

InvocationTargetException

，容易掩盖真实问题。

相关文章