引入commons-codec依赖仍报NoClassDefFoundError:Base64异常求助

报错属于编译期依赖可见、运行时类路径缺失的典型问题，本地仓库存在对应class文件不代表运行环境能加载到该类，按优先级从高到低排查以下问题：

• Ant任务类路径未配置maven依赖
  从报错栈可以看到异常是在Ant自定义任务FileGenerateTask执行时抛出的，Ant任务默认不会自动加载maven管理的依赖，这是该场景下最高发的原因。
  检查Ant的build.xml配置，需要显式将commons-codec所在的所有maven依赖加入任务类路径，参考配置：

  <!-- 定义项目依赖类路径 -->
  <path id="runtime.classpath">
      <!-- 引入commons-codec jar -->
      <fileset dir="${local.maven.repo}/commons-codec/commons-codec/1.6">
          <include name="*.jar"/>
      </fileset>
      <!-- 引入其余项目依赖、编译输出目录 -->
  </path>
  <!-- 声明自定义Ant任务时关联类路径 -->
  <taskdef name="fileGen" classname="com.cwsoft.tools.filegenerator.ant.FileGenerateTask" classpathref="runtime.classpath"/>
  

• 本地maven仓库结构异常/依赖损坏
  你贴出的本地仓库路径maven2/repository/local/org/apache/commons/codec/binary下直接存放class文件不符合maven仓库规范：正常maven仓库中该路径属于jar包内部的目录结构，仓库根路径下对应位置应该存放jar包和pom文件，直接暴露class说明你之前手动解压过jar包、或者依赖下载损坏。
  直接删除本地仓库下org/apache/commons/codec整个目录，执行命令强制重新拉取干净的依赖：

  mvn clean install -U
  

• 依赖scope配置错误
  检查pom.xml中commons-codec的依赖配置，如果scope被设置为provided、test，依赖不会被带入运行时类路径，编译阶段不会报错但运行时会触发类找不到异常。正常使用时不需要额外配置scope，默认compile即可，正确配置参考：

  <dependency>
      <groupId>commons-codec</groupId>
      <artifactId>commons-codec</artifactId>
      <version>1.6</version>
      <!-- 不要额外添加<scope>标签 -->
  </dependency>
  

• 多版本依赖冲突
  执行以下命令打印依赖树，排查是否有其他第三方组件传递引入了低版本commons-codec：

  mvn dependency:tree -Dincludes=commons-codec:commons-codec
  

  旧版HttpClient、Shiro等组件常会传递引入低版本commons-codec，部分低版本中不存在Base64类、或者类签名不匹配。如果存在多版本引入，在引入冲突组件的位置添加exclusion排除旧版本，或者在dependencyManagement节点锁定统一的commons-codec版本。

排查优先级提示：你的异常触发点是Ant任务执行，优先检查Ant类路径配置和本地仓库结构问题，这两个场景覆盖该报错90%以上的情况。

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