Jenkins CI用AntLib编译Spring Boot Batch项目报StringUtils类未定义错误
报错根因
你碰到的java.lang.NoClassDefFoundError: org.springframework.util.StringUtils 是两个问题叠加导致的:
- AntLib任务的类加载路径和项目依赖隔离:build.xml里直接通过命名空间声明方式加载spring-boot antlib时,Ant默认会从自身的安装目录加载类,根本不会把项目lib目录下的jar纳入类加载范围——而你列表里的
spring-core-5.2.9.RELEASE.jar本身就包含org.springframework.util.StringUtils类,只是类加载路径没打通。 - AntLib版本和项目版本错配:你当前用的2.4.x版本spring-boot-antlib,编译时依赖的是Spring Framework 5.3.x版本,和项目实际用的5.2.9版本存在API兼容问题,就算类加载问题解决,后续也大概率会触发其他类找不到的报错。
无需联网的修复操作
所有操作都用你现有环境里的依赖就能完成,不需要额外下载新包:
1. 替换版本完全对齐的AntLib
把现在用的2.4.0/2.4.4版本spring-boot-antlib,换成和项目Spring Boot版本一致的spring-boot-antlib-2.3.4.RELEASE.jar——这个包是Spring Boot 2.3.4官方发布的配套组件,本来就在对应版本的官方依赖包集合里,不需要找陌生来源的文件。
2. 修正build.xml的类加载配置
把原来靠自动命名空间加载antlib的写法,换成显式的任务定义,打通antlib任务和项目依赖的类加载路径:
- 先删掉项目根标签里的
xmlns:spring-boot="antlib:org.springframework.boot.ant"这行自动加载配置 - 在所有全局属性定义后面,加两个全局配置:
<!-- 定义antlib专用类路径,覆盖antlib本身和项目所有依赖 --> <path id="spring.boot.antlib.classpath"> <!-- 引入存放spring-boot-antlib的ext-lib目录下的对应jar --> <fileset dir="${basedir}/ext-lib"> <include name="spring-boot-antlib-*.jar"/> </fileset> <!-- 引入项目lib目录下的所有现有依赖(包含带StringUtils的spring-core包) --> <fileset dir="${basedir}/lib"> <include name="*.jar"/> </fileset> </path> <!-- 显式定义spring-boot可执行jar任务的类加载 --> <taskdef name="spring-boot-exejar" classname="org.springframework.boot.ant.ExeJar" classpathref="spring.boot.antlib.classpath"/> - 把原来compile目标里的
<spring-boot:exejar ...>标签,替换成刚定义的<spring-boot-exejar ...>即可,标签内部的resources、lib节点配置完全不用改动。
效果校验
改完后单独执行compile目标,先确认antlib初始化阶段不会再抛类找不到的报错。类路径打通后,antlib就能正常读取到你lib目录下的所有Spring相关类,打出来的可执行jar也会把依赖正确打包到BOOT-INF/lib路径下。
内容的提问来源于stack exchange,提问作者Marco Osorio
相关产品推荐
相关产品推荐

