在Spring Boot项目中，我们通常会使用Maven作为构建工具，因为它的强大功能和灵活性使得管理依赖变得简单。本文将详细讲解如何正确配置Maven的pom.xml文件，以便将Spring Boot项目打包成war格式，这在需要部署到传统应用服务器（如Tomcat）时非常有用。
我们需要理解Spring Boot的默认打包方式是jar，因为它内置了Tomcat服务器，可以独立运行。然而，如果我们希望将应用部署到外部的Tomcat服务器，就需要将其打包为war文件。为此，我们需要在pom.xml文件中进行如下配置：
1. **设置打包类型**：在`<project>`标签内，设置`packaging`元素为`war`，这样Maven就知道我们要构建一个war包。
```xml
<project>
...
<packaging>war</packaging>
...
</project>
```
2. **排除嵌入式Servlet容器**：由于我们不希望Spring Boot内置的Tomcat，我们需要移除`spring-boot-starter-web`中的嵌入式Servlet容器依赖。可以通过在`<dependency>`标签内添加`<exclusions>`来实现。
```xml
<dependencies>
...
<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>
...
</dependencies>
```
3. **添加`spring-boot-starter-jetty`或`spring-boot-starter-undertow`**：虽然我们排除了嵌入式Tomcat，但仍然可以选择其他的Servlet容器，比如Jetty或Undertow。如果你打算使用外部Tomcat，可以不添加任何Servlet容器。否则，可以按需添加。
4. **添加war插件**：Spring Boot提供了`spring-boot-maven-plugin`插件，用于简化打包过程。我们需要配置该插件，以便它能生成war包并处理启动类。
```xml
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<mainClass>com.example.YourApplication</mainClass> <!-- 替换为你的主类 -->
<outputDirectory>${project.build.directory}/../target/deploy</outputDirectory>
<attachWar>true</attachWar>
<warName>your-app-name</warName> <!-- 替换为你希望的war文件名 -->
</configuration>
</plugin>
</plugins>
</build>
```
5. **配置资源过滤**：如果项目中有静态资源（如HTML、CSS、JavaScript），需要确保它们被正确地复制到war包的相应位置。这可以通过`maven-resources-plugin`插件完成。
```xml
<build>
...
<resources>
<resource>
<directory>src/main/resources</directory>
<filtering>true</filtering>
<includes>
<include>**/*.properties</include>
<include>**/*.yml</include>
</includes>
</resource>
<resource>
<directory>src/main/resources</directory>
<filtering>false</filtering>
<excludes>
<exclude>**/*.properties</exclude>
<exclude>**/*.yml</exclude>
</excludes>
</resource>
</resources>
...
</build>
```
6. **处理Web-INF目录结构**：Spring Boot默认不创建Web-INF目录，但在war包中是必需的。可以使用`maven-war-plugin`来定制war包结构。
```xml
<build>
...
<plugins>
...
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>3.3.1</version>
<configuration>
<webResources>
<resource>
<directory>src/main/webapp</directory>
</resource>
</webResources>
<warName>your-app-name</warName> <!-- 同上 -->
</configuration>
</plugin>
...
</plugins>
</build>
```
7. **处理Spring Boot的自动配置**：由于我们不再使用嵌入式容器，需要调整Spring Boot的自动配置，以适应外部Tomcat。这可能涉及到对`@SpringBootApplication`注解的调整，或者在`application.properties`或`application.yml`中添加特定的配置。
完成上述步骤后，通过执行`mvn clean package`命令，Maven将生成一个war文件，可以直接部署到外部的Tomcat服务器。记住，部署前请确保Tomcat版本与Spring Boot支持的版本兼容。
以上就是Spring Boot项目正确打war包的Maven配置方法。请根据自己的项目需求进行适当的调整，并确保所有依赖都已更新至最新稳定版本。如有问题，欢迎随时咨询。
