Java反射（Reflection）完全手册：Class对象、动态调用、泛型、模块化限制全解析

不会写程序的未来程序员

666人浏览 · 2026-01-25 19:48:31

不会写程序的未来程序员 · 2026-01-25 19:48:31 发布

Java反射机制

本文系统讲解 Java 反射机制，涵盖原理、使用、性能、安全及实战建议，适合中高级开发者深入理解。

一、反射的基本概念

定义：
Java 反射（Reflection）允许程序在运行时动态获取类的元数据（如字段、方法、构造器等），并对其进行操作（创建实例、调用方法、修改字段值等），即使这些信息在编译期未知。

核心特性：

每个类在 JVM 中有且仅有一个 java.lang.Class 对象，代表其元数据。
支持绕过访问控制（通过 setAccessible(true)），但需注意安全风险。
是 Spring、Hibernate、JUnit 等框架实现“动态行为”的基石。

图1-1：Java 反射机制工作流程

二、获取 Class 对象的四种方式

方式	示例	特点
实例对象	`obj.getClass()`	需已有实例
类名字符串	`Class.forName("com.example.X")`	会触发类初始化
类字面量	`X.class`	不会触发初始化，推荐使用
基本类型	`int.class` 或 `Integer.TYPE`	两者等价

💡 注意：Class.forName(name, initialize, loader) 可控制是否初始化。

三、所有类型均有对应的 Class 对象

包括：

普通类、接口、枚举、注解
数组（int[].class）
基本类型（int.class）
void（void.class）

✅ 重要规则：
只要数组的元素类型 + 维度相同，就是同一个 Class 对象。

int[].class == int[].class; // true
int[][].class != int[].class; // false

四、类的加载与初始化

触发初始化（主动引用）：

new 创建实例
调用静态方法 / 访问非 final 静态字段
反射调用（如 Class.forName() 默认初始化）
初始化子类 → 父类先初始化

不触发初始化（被动引用）：

通过子类引用父类静态字段
定义数组：X[] arr = new X[10];
访问 static final 常量（编译期已确定）

图4-1：JVM 类加载五阶段（反射常触发“初始化”）

五、类加载器（ClassLoader）与双亲委派

三种内置加载器：

加载器	加载路径	实现语言
Bootstrap	`<JAVA_HOME>/lib`	C++（非 Java 对象）
Extension	`<JAVA_HOME>/lib/ext`	Java
AppClassLoader	`-classpath`	Java

双亲委派机制：

子加载器先委托父加载器尝试加载
防止核心类被篡改（如自定义 java.lang.String）

⚠️ Java 9+ 模块化影响：
若模块未 opens 包，则反射访问会抛出 InaccessibleObjectException。
解决方案：启动参数添加 --add-opens java.base/java.lang=ALL-UNNAMED

六、获取类的结构信息

成员类型	获取 public（含继承）	获取本类所有（含 private）
字段	`getFields()`	`getDeclaredFields()`
方法	`getMethods()`	`getDeclaredMethods()`
构造器	`getConstructors()`	`getDeclaredConstructors()`

✅ 建议：优先使用 getDeclaredXxx() + setAccessible(true) 实现完整控制。

七、动态操作类成员（含实战示例）

1. 创建对象

// 推荐方式（支持带参构造）
Constructor<?> ctor = clazz.getDeclaredConstructor(String.class);
ctor.setAccessible(true);
Object obj = ctor.newInstance("hello");

2. 调用方法

Method method = clazz.getDeclaredMethod("getName");
method.setAccessible(true);
Object result = method.invoke(obj);

3. 修改私有字段

Field field = clazz.getDeclaredField("secret");
field.setAccessible(true);
field.set(obj, "new value");

🔧 实战：通用 toString 工具（利用反射）

public static String reflectToString(Object obj) {
    Class<?> clazz = obj.getClass();
    StringBuilder sb = new StringBuilder(clazz.getSimpleName()).append("{");
    for (Field f : clazz.getDeclaredFields()) {
        f.setAccessible(true);
        try {
            sb.append(f.getName()).append("=").append(f.get(obj)).append(", ");
        } catch (IllegalAccessException e) { /* ignore */ }
    }
    return sb.replace(sb.length()-2, sb.length(), "}").toString();
}

八、性能分析与优化

调用方式	10亿次耗时（示例）	说明
直接调用	~6 ms	JIT 优化极致
反射调用	~5700 ms	含安全检查、类型校验
反射 + `setAccessible(true)`	~3000 ms	关闭访问检查，提速近 50%

📌 结论：高频场景避免反射；若必须使用，提前缓存 Method/Field 对象。

九、泛型与反射

Java 泛型在编译后被类型擦除，但签名信息保留在字节码中，可通过反射获取：

public class Box {
    private T value;
    public void set(T t) { this.value = t; }
}

// 获取方法泛型参数
Method method = Box.class.getMethod("set", Object.class);
Type genericType = method.getGenericParameterTypes()[0]; // T
if (genericType instanceof TypeVariable) {
    System.out.println(((TypeVariable<?>) genericType).getName()); // "T"
}

✅ 实际应用：Jackson、Gson 等 JSON 库依赖此机制实现泛型反序列化。

十、反射操作注解

前提：

注解必须声明 @Retention(RetentionPolicy.RUNTIME)

示例：

@Retention(RUNTIME)
@interface MyAnno { String value(); }

@MyAnno("test")
class Demo {}

// 反射读取
MyAnno anno = Demo.class.getAnnotation(MyAnno.class);
System.out.println(anno.value()); // "test"

🌟 用途：Spring 的 @Autowired、JPA 的 @Entity 等均依赖此机制。

十一、安全性与模块化限制（Java 9+）

1. SecurityManager（已废弃但曾重要）

旧版本可通过 SecurityManager 限制反射权限。

2. 模块系统（JPMS）限制

默认情况下，模块内的包不对外部开放反射访问

错误示例：

// 在模块外尝试反射 java.lang.Class 的私有字段
// 抛出: InaccessibleObjectException

解决方案：

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

💡 建议：框架作者应提供明确的模块开放说明。

十二、反射的替代方案（现代 Java）

方案	特点	适用场景
MethodHandle	更接近底层，性能优于反射	动态调用、 invokedynamic
VarHandle	安全地操作字段/数组（替代 `sun.misc.Unsafe`）	高并发、原子操作
动态代理	`Proxy.newProxyInstance()`	AOP、RPC 代理
注解处理器	编译期生成代码	减少运行时反射