运行旧遗留Java代码时出现NoClassDefFoundError报错求助

这个错误的核心原因是运行时JVM找不到Log4j 1.x的核心类文件，大概率是依赖缺失或者classpath配置问题，以下是几种可行的解决办法：

• 手动补全Log4j 1.x依赖
  如果是手动管理jar包的老旧项目，先下载对应版本的log4j.jar（旧项目常用1.2.17这个稳定版），把它放到项目的lib目录下，然后在运行时通过classpath指定：

  # Linux/macOS系统
  java -cp "你的应用.jar:./lib/log4j.jar" 你的主类全路径
  # Windows系统用分号分隔路径
  java -cp "你的应用.jar;./lib/log4j.jar" 你的主类全路径
  

  要是之前用Maven管理，直接在pom.xml里加这段依赖再重新打包：

  <dependency>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
      <version>1.2.17</version>
  </dependency>
  

• 迁移到Log4j 2.x（推荐，若允许修改代码）
  Log4j 1.x早就停止维护，还有安全漏洞，要是能改代码的话建议升级到Log4j 2：

  1. 删掉旧的log4j.jar，在Maven里加Log4j 2的核心依赖：

     <dependency>
         <groupId>org.apache.logging.log4j</groupId>
         <artifactId>log4j-core</artifactId>
         <version>2.20.0</version>
     </dependency>
     <dependency>
         <groupId>org.apache.logging.log4j</groupId>
         <artifactId>log4j-api</artifactId>
         <version>2.20.0</version>
     </dependency>
     

  2. 不想改原有代码的import？可以加个桥接包，让旧的Log4j 1.x代码直接用Log4j 2的实现：

     <dependency>
         <groupId>org.apache.logging.log4j</groupId>
         <artifactId>log4j-1.2-api</artifactId>
         <version>2.20.0</version>
     </dependency>
     

• 检查运行环境的classpath配置
  有时候全局CLASSPATH环境变量被修改，或者运行命令里的classpath没包含依赖jar，导致JVM找不到类。仔细核对运行命令里的classpath参数，或者检查系统的CLASSPATH变量是否正确包含了log4j.jar的路径。

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