Java常用反射类库与Constructor

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），改用更底层、更可控的方式。

• JDK 9 起，该方法被标记为废弃，因它会额外包装异常（把构造器内抛的 RuntimeException 包成 InvocationTargetException），增加调试成本
• 主流方案转向 Unsafe.all

  

  ocateInstance(clazz)（跳过构造器执行，适用于无参且无需初始化字段的场景），或使用字节码生成（如 CGLIB）动态构造代理类
• 如果你在写工具类，也建议封装一层：对无参构造优先用 getDeclaredConstructor().newInstance()，有参则严格校验类型并捕获 InvocationTargetException 后 rethrow getCause()

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