从ObjectInputStream读取序列化对象时遇奇怪ClassNotFoundException

这种序列化加载时碰到的ClassNotFoundException确实挺闹心的，我之前在多线程和类加载器复杂的场景里也踩过类似的坑，给你梳理几个最可能的原因和对应的解决办法：

1. 类加载器上下文不一致（最常见的“诡异”原因） #

ObjectInputStream默认会用当前线程的上下文类加载器或者加载自身的类加载器来查找要反序列化的类。如果你的mypackage.MyClass是由另一个类加载器加载的（比如自定义类加载器、Web容器的类加载器），而线程mythread的上下文类加载器找不到这个类，就会抛出异常。

解决办法是自定义一个ObjectInputStream，重写resolveClass方法，指定能找到MyClass的类加载器：

class CustomObjectInputStream extends ObjectInputStream {
    private final ClassLoader targetClassLoader;

    public CustomObjectInputStream(InputStream inputStream, ClassLoader classLoader) throws IOException {
        super(inputStream);
        this.targetClassLoader = classLoader;
    }

    @Override
    protected Class<?> resolveClass(ObjectStreamClass desc) throws IOException, ClassNotFoundException {
        // 用指定的类加载器加载目标类
        try {
            return Class.forName(desc.getName(), false, targetClassLoader);
        } catch (ClassNotFoundException e) {
            // 如果找不到，再 fallback 到父类的默认逻辑
            return super.resolveClass(desc);
        }
    }
}

使用的时候，传入加载MyClass的类加载器即可，比如：

// 假设MyClass是由当前类的加载器加载的，就用这个
ClassLoader loader = MyClass.class.getClassLoader();
try (CustomObjectInputStream ois = new CustomObjectInputStream(new FileInputStream("data.ser"), loader)) {
    MyClass obj = (MyClass) ois.readObject();
}

2. 运行时类路径缺失 #

别忽略最基础的检查：确认你的运行环境类路径里确实包含mypackage.MyClass的字节码文件。比如：

• 如果是普通Java项目，检查启动参数的-classpath有没有包含对应class文件所在的目录或jar包；
• 如果是Web应用，确保这个类在WEB-INF/classes目录下或者对应的依赖jar包在WEB-INF/lib里；
• 如果是动态加载场景，可能线程运行时的类路径和你预期的不一样，需要手动添加类路径。

3. 类的全限定名不匹配 #

如果序列化之后，MyClass的包名或者类名被修改过（比如重构了包结构），那么反序列化时就会找不到原来的类。要确保序列化和反序列化的类全限定名完全一致，包括包名和类名。

4. 类版本或序列化ID问题 #

虽然这个通常会抛出InvalidClassException，但如果MyClass被删除后重新创建，且没有显式指定serialVersionUID，JVM会自动生成一个新的ID，这时候也可能间接导致类加载时的异常。建议给序列化类显式添加serialVersionUID：

public class MyClass implements Serializable {
    private static final long serialVersionUID = 1L;
    // 类的其他内容
}

先从类加载器的问题入手排查吧，这是这种“明明类存在却找不到”场景的核心原因，尤其是在多线程环境下，线程的上下文类加载器很容易和预期不一致。

内容的提问来源于stack exchange，提问作者Seppo420