翻译:官方文档第92.1节
注意:
因为
Spring WebFlux
不直接依赖于Servlet API
,应用直接部署到内置的嵌入式Reactor
容器Netty Server
上,因此Spring WebFlux
应用不支持war
形式的部署。
通常,SpringBoot
提供了内置嵌入式tomcat
容器,因此可以直接将SpringBoot
应用打包成jar
包,并通过java -jar
运行。
但是,如果想要将SpringBoot
应用打包成war
包,并部署到外部tomcat
容器中运行,需要以下几步:
- 改写应用的启动类
Application
,使其继承SpringBootServletInitializer
,并重写configure
方法:
@SpringBootApplication
public class Application extends SpringBootServletInitializer {
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
return builder.sources(Application.class);
}
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
- 修改
pom.xml
配置文件,将jar
修改为war
:
<packaging>war</packaging>
- 确保嵌入式
tomcat
的jar
包在运行时不引入,可以通过指定<scope>provided</scope>
实现:
<!-- 打包成war包时需要在运行时移除嵌入式tomcat包 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
<scope>provided</scope>
表示这个依赖在编译期和测试期引入,在运行期移除。
需要注意的一点,<build>
里面的<finalName>
最好和application.properties
中的server.servlet.context-path
保持一致。
- 设置打包生成的
war
包名:
<!-- 打包生成的war包名 -->
<finalName>app</finalName>
- 设置
web
应用上下文:
server.servlet.context-path=/app