程序运行期发生ClassNotFoundException 可能是什么原因？

星辰@Sea

已于 2024-09-23 18:33:05 修改

阅读量771

点赞数 24

分类专栏： Java 其他文章标签： java

于 2024-09-23 18:32:56 首次发布

本文链接：https://blog.csdn.net/wls_gk/article/details/142465316

版权

Java 同时被 2 个专栏收录

25 篇文章 0 订阅

订阅专栏

其他

7 篇文章 0 订阅

订阅专栏

引言

作为一名Java开发工程师，我深知软件部署过程中遇到的问题可能给业务带来的影响。今天，我要分享的是最近在线上环境中遇到的一次ClassNotFoundException问题的排查与解决过程。这个经历不仅让我对类加载机制有了更深的理解，同时也让我意识到了持续集成/持续部署（CI/CD）流程的重要性。

问题描述

今天早上，我们的生产环境突然报错，用户反馈说部分功能无法正常使用。登录到生产环境的服务器，我查看了应用的日志文件，发现了一连串的ClassNotFoundException异常：

2024-09-23 09:15:30 ERROR [main] - java.lang.ClassNotFoundException: com.example.service.UserService
 at java.net.URLClassLoader.findClass(URLClassLoader.java:381)
 at java.lang.ClassLoader.loadClass(ClassLoader.java:424)
 at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:335)
 at java.lang.ClassLoader.loadClass(ClassLoader.java:357)
 ...

显然，UserService类在运行时没有被正确加载。这个类是我们应用中的关键组件之一，用于处理用户相关的业务逻辑。因此，这个问题必须尽快解决。

初步诊断

面对这样的异常，我的第一步是检查错误日志，以获取更多信息。从日志中可以看出，异常发生在类加载阶段，具体是UserService类没有被找到。

初步猜测可能是以下几种情况：

类没有被正确部署。
类路径设置不正确。
依赖关系问题，例如缺少必要的库或版本不匹配。

深入排查

步骤1: 查看错误日志

我再次仔细阅读了日志文件，确认除了UserService之外是否有其他相关类也出现了同样的问题。同时，我也注意到了异常发生的上下文，比如是在启动时还是在某些特定操作时触发的。

2024-09-23 09:15:30 ERROR [main] - java.lang.ClassNotFoundException: com.example.service.UserService

日志表明，异常发生在应用启动初期，这意味着问题很可能出现在依赖管理或类路径配置上。

步骤2: 检查类路径

接着，我检查了类路径设置。对于部署在Tomcat上的Java Web应用而言，类路径通常包含如下几个部分：

应用自身的.war文件解压后的classes目录。
WEB-INF/lib目录下的所有jar包。
Tomcat自身的lib目录中的jar包（如果有配置的话）。

我通过SSH登录到服务器，并进入应用的部署目录，检查WEB-INF/lib下的内容：

ls WEB-INF/lib/

输出结果表明，userService.jar确实不在其中。

步骤3: 验证依赖关系

考虑到可能是依赖管理的问题，我决定检查Maven项目的pom.xml文件。打开本地的项目仓库，我查看了pom.xml中关于userService的依赖声明：

<dependency>
    <groupId>com.example</groupId>
    <artifactId>userService</artifactId>
    <version>1.0.0</version>
</dependency>

看起来一切都正常。为了进一步验证，我在本地环境中执行了mvn dependency:tree命令，得到了完整的依赖树：

mvn dependency:tree

依赖树显示userService的确存在，并且版本号正确无误。

步骤4: 分析ClassLoader

考虑到可能的类加载器问题，我决定深入研究类加载的过程。在Java中，类加载器分为三个层次：

Bootstrap ClassLoader
Extension ClassLoader
Application ClassLoader (System ClassLoader)

为了确认UserService类究竟由哪个类加载器加载，我可以在代码中打印出来：

public class MyClass {
    public static void main(String[] args) {
        ClassLoader classLoader = UserService.class.getClassLoader();
        System.out.println(classLoader);
    }
}