SpringBoot项目本地Eclipse运行正常，部署云服务器后出现ClassNotFoundException

云上老周

2026-10-2

Spring Boot反射加载DTO本地正常云端报ClassNotFoundException解决方案

大小写不一致问题
本地运行的Windows/macOS系统对文件路径大小写不敏感，即使全限定名大小写和实际类路径有差异也能正常加载，而云端部署通常为Linux环境，严格区分大小写。请确认className参数取值com.abc.dto.AbcDTO的大小写、包名和实际类的全限定名完全一致。
部署包缺失类文件
请解压云端部署使用的Spring Boot可执行Jar包，检查BOOT-INF/classes/com/abc/dto/AbcDTO.class是否存在，同时确认ReaderInterface类文件也存在于BOOT-INF/lib下的对应依赖Jar或者BOOT-INF/classes目录中。
若类文件缺失，检查spring-boot-maven-plugin配置，确认没有配置exclude规则过滤DTO所在包，且DTO所在依赖的scope不是provided。
类加载器隔离问题
部分云部署平台、类隔离框架（如SOFAArk、OSGi）会自定义类加载逻辑，导致工具类所在Jar的类加载器无法访问业务项目的类路径。可以增加类加载器降级逻辑，代码示例如下：

public class AbcFileReader<T extends ReaderInterface>{
    public List<T> readFile(File file, String className) throws Exception {
        Class<T> clazz;
        // 优先尝试上下文类加载器
        try {
            clazz = (Class<T>) Class.forName(className, true, Thread.currentThread().getContextClassLoader());
        } catch (ClassNotFoundException e) {
            // 降级使用当前工具类的类加载器
            clazz = (Class<T>) Class.forName(className, true, AbcFileReader.class.getClassLoader());
        }
        // 替换已废弃的newInstance()，避免构造函数权限问题
        T newObj = clazz.getDeclaredConstructor().newInstance();
        // 后续业务逻辑
    }
}