NoClassDefFoundError 错误

报错信息:

错误原因

NoClassDefFoundError的错误是因为在运行时类加载器在classpath下找不到需要加载的类,所以我们需要把对应的类加载到classpath中,或者检查为什么类在classpath中是不可用的,这个发生可能的原因如下:

  1. 对应的Class在java的classpath中不可用
  2. 你可能用jar命令运行你的程序,但类并没有在jar文件的manifest文件中的classpath属性中定义
  3. 可能程序的启动脚本覆盖了原来的classpath环境变量
  4. 因为NoClassDefFoundError是java.lang.LinkageError的一个子类,所以可能由于程序依赖的原生的类库不可用而导致
  5. 检查日志文件中是否有java.lang.ExceptionInInitializerError这样的错误,NoClassDefFoundError有可能是由于静态初始化失败导致的如果你工作在J2EE的环境,有多个不同的类加载器,也可能导致NoClassDefFoundError

排查方法

排查的方法如下:

  1. CLASSPATH 靠前的jar优先加载。
  2. Jinfo命令可以直接查看Java进程的CLASSPATH 。
  3. ClassLoader.getResource 可以确定某个类是由哪个jar包加载的。
  4. mvn dependency:tree -Dverbose 可以确定程序中到底是哪些jar包冲突。
  5. HBASE_CLASSPATH_PREFIX 中的jar包 HBase会优先加载。Tomcat 会优先加载web相关的jar。
    NoClassDefFoundError发生在编译时对应的类可用,而运行时在Java的classpath路径中,对应的类不可用导致的错误。