Spring Boot整合Ant实现传统方式构建打包的完整步骤详解

Ant是Apache基金会推出的老牌构建工具，基于XML描述构建过程，虽然如今大部分新项目都使用Maven或Gradle，但在不少传统企业环境中，Ant构建脚本依然承担着日常的打包发布工作。Spring Boot官方其实也照顾到了这部分用户，提供了一个名为spring-boot-antlib的Ant扩展库，让Ant也能顺利构建出可执行jar。本文将完整讲解如何为Spring Boot项目编写Ant构建脚本，包括依赖准备、build.xml编写、打包配置和常见问题处理。

一、准备工作：项目结构与依赖库获取

在开始编写Ant脚本之前，需要先确认项目结构。为了让示例更贴近实际，这里假设项目采用标准的Maven目录布局：源代码放在src\main\java下，资源文件放在src\main\resources下，输出的class文件编译到target\classes目录。这种布局的好处是，如果团队中同时存在Maven和Ant两套构建方式，目录结构可以完全复用，不需要做额外调整。

Ant本身不负责依赖管理，这是它与Maven最大的区别。要让Ant构建Spring Boot项目成功，需要先把依赖jar准备好。有两种常见做法：第一种是通过Maven先执行一次mvn dependency:copy-dependencies，把所有依赖复制到target\dependency目录，之后Ant构建时直接引用这个目录；第二种是在内网手工维护一个lib目录，把需要的jar统一放进去。第二种方式在内网无外网访问权限的环境里非常常见，虽然维护成本高一些，但胜在稳定可控。

除了项目依赖之外，还需要下载spring-boot-antlib这个扩展包。它可以在Maven中央仓库中找到，坐标为org.springframework.boot:spring-boot-antlib。这个包提供了<springboot:exejar>等任务，专门用来生成Spring Boot要求的可执行jar格式，能省去手工编写MANIFEST.MF和处理嵌套jar的麻烦。

二、编写build.xml：编译与资源处理

build.xml是Ant构建的核心。首先需要定义几个基础任务：clean清理输出目录、compile编译源码、copy-resources复制资源文件。下面是一个可以直接使用的完整脚本框架：

<?xml version="1.0" encoding="UTF-8"?>
<project name="springboot-ant-demo" default="build" basedir=".">

    <property name="src.dir" value="src/main/java"/>
    <property name="res.dir" value="src/main/resources"/>
    <property name="build.dir" value="target"/>
    <property name="classes.dir" value="${build.dir}/classes"/>
    <property name="lib.dir" value="target/dependency"/>
    <property name="antlib.jar" value="lib/spring-boot-antlib-2.7.18.jar"/>

    <path id="compile.classpath">
        <fileset dir="${lib.dir}">
            <include name="**/*.jar"/>
        </fileset>
    </path>

    <target name="clean">
        <delete dir="${build.dir}"/>
    </target>

    <target name="compile" depends="clean">
        <mkdir dir="${classes.dir}"/>
        <javac srcdir="${src.dir}" destdir="${classes.dir}"
               source="1.8" target="1.8" encoding="UTF-8"
               includeantruntime="false">
            <classpath refid="compile.classpath"/>
        </javac>
    </target>

    <target name="copy-resources" depends="compile">
        <copy todir="${classes.dir}">
            <fileset dir="${res.dir}"/>
        </copy>
    </target>

</project>

这个脚本里有几个容易踩坑的地方。首先是encoding="UTF-8"必须显式指定，否则在Windows环境下编译含中文注释的源码时会出现乱码甚至编译失败。其次是includeantruntime="false"，加上它可以避免Ant自身的jar被混入编译classpath，减少不必要的干扰。最后是source和target的设置，要与项目的JDK版本保持一致，如果团队用的是JDK 11或17，记得同步修改这里。

资源文件的复制经常被忽略。Spring Boot应用的application.yml、静态页面、MyBatis的mapper XML等都存放在resources目录下，如果不执行复制，打出来的jar启动时会直接报找不到配置的错误。上面的copy-resources任务把整个resources目录原样复制到classes目录，保持了与Maven一致的行为。

三、使用spring-boot-antlib打包可执行jar

接下来是最关键的一步：打包成Spring Boot认可的可执行fat jar。Spring Boot的可执行jar有特殊的目录结构，BOOT-INF\classes存放应用类，BOOT-INF\lib存放依赖jar，META-INF下的MANIFEST.MF要指定Main-Class为org.springframework.boot.loader.JarLauncher，并通过Start-Class指明真正的业务启动类。手工用Ant的jar任务拼出这个结构是可以的，但繁琐且容易出错，推荐直接使用spring-boot-antlib。

使用之前要先声明命名空间并引入任务定义，然后在打包任务中指定入口类和依赖路径，完整示例如下：

<project xmlns:springboot="antlib:org.springframework.boot.ant"
         name="springboot-ant-demo" default="build" basedir=".">

    <!-- 前面的property和path定义与上面相同，此处省略 -->

    <target name="boot-jar" depends="copy-resources">
        <springboot:exejar destfile="${build.dir}/demo-app.jar"
                          mainclass="com.example.DemoApplication">
            <springboot:resources>
                <fileset dir="${classes.dir}"/>
            </springboot:resources>
            <lib>
                <fileset dir="${lib.dir}"/>
                <pathelement location="${antlib.jar}"/>
            </lib>
        </springboot:exejar>
    </target>

    <target name="build" depends="boot-jar"/>

</project>

<springboot:exejar>任务会自动完成所有格式处理：生成正确的MANIFEST.MF、把业务类放入BOOT-INF\classes、把依赖放进BOOT-INF\lib，并且按Spring Boot的要求对嵌套jar的存储格式做处理（这一点很重要，Spring Boot 1.4之后要求嵌套jar必须以无压缩方式存储，普通jar任务做不到）。打包完成后，直接执行java -jar target\demo-app.jar即可启动应用。

需要特别说明的是<lib>部分的配置。spring-boot-antlib要求打包任务自身所在的类路径上要有spring-boot-loader相关类，通常把spring-boot-antlib的jar一并加入即可满足。如果构建时抛出ClassNotFoundException，且缺的类名以org.springframework.boot.loader开头，基本可以确定就是这个原因，把antlib的jar加进lib集合就能解决。

四、常见问题排查与替代方案

实际使用中问题主要集中在几类。第一类是打包成功但启动报错no main manifest attribute，这说明jar没有按照Spring Boot格式生成，多半是没有使用<springboot:exejar>而是用了普通jar任务，检查打包任务的写法即可。第二类是启动时找不到依赖类，通常是lib目录中的依赖不全，可以对比Maven构建的BOOT-INF\lib目录内容，逐一补齐缺失的jar。第三类是配置文件不生效，检查resources目录是否被正确复制进了打包范围。

还有一种情况是团队不想引入spring-boot-antlib，这时可以退而求其次，用普通jar任务手工构造清单文件，把Main-Class写为JarLauncher，再通过zipfileset把依赖以STORED方式压入BOOT-INF\lib。这种方式可行但代码量更大，而且要小心处理压缩方式，一般只建议在无法引入额外jar的极端受限环境下使用。

最后补充一点工程实践建议：如果项目还处于活跃开发阶段，开发时继续用Maven管理依赖、本地调试，只在发布环节用Ant执行打包，两套工具各司其职，是维护成本最低的组合方式。Ant构建脚本可以纳入版本管理，配合Jenkins等CI工具的Ant插件，就能实现完整的自动化发布流水线。整体来看，Ant构建Spring Boot应用虽然步骤多一些，但过程完全透明可控，非常适合对构建有严格审计要求的场景。

Spring BootAnt构建构建打包修改时间：2026-09-14 08:34:41