从Jar到War：SpringBoot项目打包类型切换全攻略（含IDEA 2023.3+与Maven 3.9+配置）

在SpringBoot项目的实际部署中，开发者常常面临一个关键选择：究竟该使用轻量级的Jar包部署，还是传统的War包部署？这个看似简单的决策背后，其实涉及到项目架构、运行环境、运维习惯等多重因素。最近在技术社区看到不少讨论，有团队在容器化迁移过程中发现原先的War包部署方式与K8s环境存在兼容性问题，也有企业在传统Tomcat集群中强行使用Jar包导致运维复杂度陡增。本文将带您深入理解这两种打包方式的本质差异，并手把手演示如何在最新开发环境下进行灵活切换。

1. 理解Jar与War的本质区别

1.1 架构设计差异

SpringBoot的Jar包采用 嵌入式容器 设计，将Tomcat、Jetty等服务器作为依赖库打包进应用。这种"all-in-one"的方案使得：

• 应用成为自包含单元
• 无需预装Web服务器
• 启动方式统一（ java -jar ）

而War包延续Java EE传统，需要 外部容器 支持：

<!-- 典型War包依赖配置 -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <scope>provided</scope>
</dependency>

1.2 性能特征对比

维度	Jar包方案	War包方案
启动速度	较快（内嵌容器优化）	较慢（容器初始化开销）
内存占用	较高（包含容器运行时）	较低（容器共享）
部署密度	较低（单进程）	较高（多应用共享容器）

提示：在微服务架构下，Jar包的独立部署特性往往更受欢迎；而在传统企业环境中，War包的集中管理优势仍然存在价值。

2. 项目改造前的环境准备

2.1 IDEA 2023.3+配置检查

1. 确认Maven集成模式：

   • 导航到 File → Build → Build Tools → Maven
   • 确保"Use Maven wrapper"选项未勾选（避免版本冲突）

2. 验证项目JDK版本：

# 在终端执行
mvn -v

应输出类似信息：

Apache Maven 3.9.6
Java version: 17.0.8

2.2 Maven 3.9+关键插件配置

在父pom.xml中声明插件管理：

<pluginManagement>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>3.1.5</version>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.3.2</version>
        </plugin>
    </plugins>
</pluginManagement>

3. 从Jar到War的完整转换流程

3.1 基础配置修改

1. 修改packaging类型：

<!-- 原Jar配置 -->
<packaging>jar</packaging>

<!-- 改为War配置 -->
<packaging>war</packaging>

2. 排除内嵌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>

3.2 初始化Servlet支持

创建SpringBootServletInitializer子类：

@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);
    }
}

3.3 多模块项目特殊处理

对于依赖其他模块的情况，需要在被依赖模块中配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <skip>false</skip>
            </configuration>
        </plugin>
    </plugins>
</build>

4. 高级配置与优化技巧

4.1 资源过滤配置

确保静态资源正确打包：

<resources>
    <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
        <includes>
            <include>**/*.properties</include>
            <include>**/*.xml</include>
        </includes>
    </resource>
    <resource>
        <directory>src/main/webapp</directory>
        <targetPath>WEB-INF</targetPath>
    </resource>
</resources>

4.2 部署描述符定制

创建 src/main/webapp/WEB-INF/web.xml ：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee 
         http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
    
    <context-param>
        <param-name>spring.profiles.active</param-name>
        <param-value>production</param-value>
    </context-param>
    
    <error-page>
        <error-code>404</error-code>
        <location>/error</location>
    </error-page>
</web-app>

4.3 构建过程加速

在 settings.xml 中配置并行构建：

<settings>
    <profiles>
        <profile>
            <id>fast-build</id>
            <properties>
                <maven.compiler.useIncrementalCompilation>false</maven.compiler.useIncrementalCompilation>
                <maven.test.skip>true</maven.test.skip>
            </properties>
        </profile>
    </profiles>
    <activeProfiles>
        <activeProfile>fast-build</activeProfile>
    </activeProfiles>
</settings>

5. 常见问题排查指南

5.1 类加载问题

症状：War部署后出现 ClassNotFoundException

解决方案：

1. 检查 WEB-INF/lib 目录是否包含所有依赖
2. 确认Tomcat配置：

# conf/catalina.properties
tomcat.util.scan.StandardJarScanFilter.jarsToSkip=*.jar

5.2 静态资源404错误

调试步骤：

1. 验证资源路径：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/static/**")
                .addResourceLocations("classpath:/static/");
    }
}

2. 检查 spring.resources.static-locations 配置

5.3 多环境配置冲突

推荐方案：

1. 使用Profile-specific配置：

mvn clean package -Pprod

2. 在 application-prod.properties 中覆盖默认值

6. 现代部署环境下的最佳实践

6.1 容器化部署方案

即使使用War包，也可以结合Docker：

FROM tomcat:9.0-jdk17
COPY target/*.war /usr/local/tomcat/webapps/ROOT.war
EXPOSE 8080
CMD ["catalina.sh", "run"]

6.2 构建产物验证

添加集成测试阶段：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-verifier-plugin</artifactId>
    <executions>
        <execution>
            <goals>
                <goal>verify</goal>
            </goals>
            <configuration>
                <verificationFile>src/test/verify/package-verify.xml</verificationFile>
            </configuration>
        </execution>
    </executions>
</plugin>

6.3 构建缓存优化

配置增量构建：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <configuration>
        <useDefaultManifestFile>true</useDefaultManifestFile>
        <archive>
            <manifest>
                <addDefaultImplementationEntries>true</addDefaultImplementationEntries>
            </manifest>
        </archive>
    </configuration>
</plugin>

在最近的一个企业级项目迁移中，我们团队将原有War包部署的SpringBoot应用改造为Jar包部署，部署时间从原来的15分钟缩短到90秒。但值得注意的是，这种转换并非放之四海皆准——当遇到需要与遗留系统共享会话状态的场景时，传统的War包部署反而展现出其不可替代的价值。