在Java开发中,动态加载类的需求十分常见,比如根据配置文件中的类名初始化不同的业务实现类,或者开发插件化架构时加载外部插件类。Class.forName()方法就是实现这一需求的核心途径,它可以根据传入的完整类名字符串,触发对应类的加载流程,将类信息加载到JVM的方法区中。

Class.forName()的基本用法
Class.forName()是java.lang.Class类的静态方法,最常用的重载形式是接收一个字符串参数,该参数需要是类的全限定名,也就是包名加类名。方法调用成功后会返回对应的Class对象,如果类不存在或者加载失败则会抛出异常。
下面是一个最简单的使用示例,加载Java内置的java.util.ArrayList类:
public class ForNameDemo {
public static void main(String[] args) {
try {
// 传入ArrayList的全限定类名字符串
Class<?> clazz = Class.forName("java.util.ArrayList");
System.out.println("加载到的类名称:" + clazz.getName());
// 可以通过Class对象创建实例
Object instance = clazz.getDeclaredConstructor().newInstance();
System.out.println("创建的实例类型:" + instance.getClass().getSimpleName());
} catch (Exception e) {
e.printStackTrace();
}
}
}
Class.forName()的底层加载逻辑
Class.forName()的加载过程依赖于类加载器,默认情况下会使用调用者的类加载器来加载目标类。它实际上会调用另一个重载方法Class.forName(String name, boolean initialize, ClassLoader loader),其中第二个参数initialize表示是否对类进行初始化,默认传入的是true,也就是说使用Class.forName()加载类时,默认会执行类的静态代码块和静态变量的赋值操作。
我们可以通过一个自定义类来验证初始化的过程:
// 自定义测试类
class TestClass {
// 静态变量
public static String staticField = "静态变量初始值";
// 静态代码块
static {
System.out.println("TestClass的静态代码块被执行了");
staticField = "静态代码块修改后的值";
}
}
public class ForNameInitDemo {
public static void main(String[] args) {
try {
System.out.println("开始调用Class.forName()");
Class<?> clazz = Class.forName("TestClass");
System.out.println("加载完成后静态变量的值:" + TestClass.staticField);
} catch (Exception e) {
e.printStackTrace();
}
}
}
运行上述代码后,会先输出静态代码块的内容,再输出静态变量被修改后的值,说明类确实被初始化了。
不同场景下的使用注意事项
1. 类名字符串必须准确
传入的必须是类的全限定名,不能省略包名,也不能写错类名的大小写,否则会抛出ClassNotFoundException。比如加载ArrayList时如果只写ArrayList而不是java.util.ArrayList,就会加载失败。
2. 处理受检异常
Class.forName()会抛出ClassNotFoundException,这是一个受检异常,调用时必须进行捕获或者在方法上声明抛出,否则代码无法通过编译。
3. 自定义类加载器的使用
如果需要使用特定的类加载器加载类,比如加载插件目录下的类,可以调用三个参数的重载方法,显式传入类加载器:
public class CustomClassLoaderDemo {
public static void main(String[] args) {
// 自定义类加载器,这里简化为使用系统类加载器示例
ClassLoader customLoader = ClassLoader.getSystemClassLoader();
try {
// 使用自定义类加载器加载类,且不进行初始化
Class<?> clazz = Class.forName("java.util.HashMap", false, customLoader);
System.out.println("使用自定义类加载器加载到的类:" + clazz.getName());
} catch (Exception e) {
e.printStackTrace();
}
}
}
常见应用场景
- 数据库驱动加载:早期JDBC连接数据库时,需要通过
Class.forName("com.mysql.cj.jdbc.Driver")加载驱动类,驱动类的静态代码块会把自己注册到驱动管理器中。 - 插件化架构:主程序根据插件配置文件中写的类名,动态加载插件类并实例化,实现功能扩展。
- 依赖注入框架:框架根据配置的Bean类名,动态加载类并创建实例,管理对象的生命周期。
与ClassLoader.loadClass()的区别
很多开发者会混淆Class.forName()和ClassLoader.loadClass()方法,两者的核心区别如下:
| 对比项 | Class.forName() | ClassLoader.loadClass() |
|---|---|---|
| 默认是否初始化类 | 是 | 否 |
| 返回值 | 返回Class对象 | 返回Class对象 |
| 异常类型 | ClassNotFoundException | ClassNotFoundException |
| 使用场景 | 需要类初始化时使用 | 只需要加载类不需要初始化时使用 |
如果只需要加载类的字节码到JVM,不需要执行静态代码块,可以优先选择ClassLoader.loadClass()方法。
常见问题排查
如果调用Class.forName()时出现ClassNotFoundException,可以从以下几个方面排查:
- 检查类名字符串是否正确,是否包含完整的包名,类名大小写是否匹配。
- 检查目标类的字节码文件是否在类加载器的加载路径下,比如如果是自定义类,是否在classpath中。
- 如果使用的是自定义类加载器,检查类加载器的加载路径是否包含了目标类的位置。
注意:如果加载的是数组类型的类,类名字符串需要按照数组的命名规则写,比如一维int数组的类名是[I,String数组的类名是[Ljava.lang.String;,使用Class.forName()也可以加载这些数组类。
Class.forName()Java动态加载类JVM类加载反射机制类名字符串修改时间:2026-07-20 03:30:28