当前位置:首页 > 技术 > 正文内容

Spring Boot 应用打包为包含外部依赖的 WAR 文件

访客 技术 2026年6月1日 1

修改项目打包类型为 WAR

在 Maven 的 pom.xml 文件中,将默认的 jar 打包方式更改为 war

<packaging>war</packaging>

引入本地第三方 JAR 依赖

若项目依赖未发布到中央仓库的 JAR 包(如存放在 src/main/resources/lib 目录下),可通过 system 范围进行引用。例如,添加一个名为 otc-commons-logging-1.2.jar 的本地库:

<dependency>
    <groupId>otc</groupId>
    <artifactId>commons-logging</artifactId>
    <version>1.2</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/src/main/resources/lib/otc-commons-logging-1.2.jar</systemPath>
</dependency>

注意:system 类型依赖不会自动包含在最终构建产物中,需配合插件手动处理。

排除嵌入式 Tomcat 容器

由于应用将部署至外部 Servlet 容器(如独立安装的 Tomcat),需移除 Spring Boot 内置的 Tomcat 组件。以下是两种可行方案:

方案一:显式声明并设为 provided 范围

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>

此配置表示该依赖参与编译和测试,但在打包时不会被打进 WAR 文件。

方案二:从 web 启动器中排除 Tomcat

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>

这种方式通过排除机制移除内嵌容器,效果与第一种一致。

配置 Maven 插件以包含本地 JAR

为确保本地依赖被复制到 WAR 包的 WEB-INF/lib 目录下,需使用 maven-war-plugin 自定义资源拷贝行为:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <version>3.3.0</version>
    <configuration>
        <webResources>
            <resource>
                <directory>src/main/resources/lib</directory>
                <targetPath>WEB-INF/lib</targetPath>
                <includes>
                    <include>**/*.jar</include>
                </includes>
            </resource>
        </webResources>
    </configuration>
</plugin>

同时建议保留编译插件设置以兼容特定 JDK 版本:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <compilerArgs>
            <arg>-bootclasspath</arg>
            <arg>${JAVA_HOME}/jre/lib/rt.jar</arg>
        </compilerArgs>
    </configuration>
</plugin>

调整启动类以支持外部 Servlet 容器

Spring Boot 默认以 Java Application 方式启动,但部署到外部 Tomcat 需要基于传统 Servlet 上下文加载。因此,主应用类应继承 SpringBootServletInitializer 并重写 configure 方法:

@SpringBootApplication
public class MyApplication extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(MyApplication.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

这样既能支持 IDE 内直接运行调试,也能适配外部容器部署场景。

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。