目录
1、继承SpringBootServletInitializer
4.3、Error assembling WAR: web.xml attribute is required
配置步骤：
1、继承SpringBootServletInitializer
- 外部容器部署的话，就不能依赖于Application的main函数了，而是要以类似于web.xml文件配置的方式来启动Spring应用上下文，此时我们需要在启动类中继承SpringBootServletInitializer并实现configure方法：
import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.boot.builder.SpringApplicationBuilder; import org.springframework.boot.web.servlet.support.SpringBootServletInitializer; @SpringBootApplication public class SdkCmsApplication extends SpringBootServletInitializer { /** * @Title: 使用外置tomcat部署 * @MethodName: configure * @param application * @Return org.springframework.boot.builder.SpringApplicationBuilder * @Exception * @Description: * * @author: FLY * @date: 2019-05-24 14:02 */ @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder application) { return application.sources(SdkCmsApplication.class); } public static void main(String[] args) { SpringApplication.run(SdkCmsApplication.class, args); } }
- 这个类的作用与在web.xml中配置负责初始化Spring应用上下文的监听器作用类似，只不过在这里不需要编写额外的XML文件了。
2、pom.xml修改tomcat相关的配置
首先介绍下maven中scope依赖范围的概念，因为后续涉及到这个会有问题。
依赖范围就是用来控制依赖和三种classpath(编译classpath，测试classpath、运行classpath)的关系，Maven有如下几种依赖范围：
- compile:编译依赖范围。如果没有指定，就会默认使用该依赖范围。使用此依赖范围的Maven依赖，对于编译、测试、运行三种classpath都有效。典型的例子是spring-code,在编译、测试和运行的时候都需要使用该依赖。
- test: 测试依赖范围。使用次依赖范围的Maven依赖，只对于测试classpath有效，在编译主代码或者运行项目的使用时将无法使用此依赖。典型的例子是Jnuit,它只有在编译测试代码及运行测试的时候才需要。
- provided:已提供依赖范围。使用此依赖范围的Maven依赖，对于编译和测试classpath有效，但在运行时候无效。典型的例子是servlet-api,编译和测试项目的时候需要该依赖，但在运行项目的时候，由于容器以及提供，就不需要Maven重复地引入一遍。
- 更多scope说明，参考：https://blog.csdn.net/fly910905/article/details/78089359
如果要将最终的打包形式改为war的话，还需要对pom.xml文件进行修改，因为spring-boot-starter-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>
在这里需要移除对嵌入式Tomcat的依赖，这样打出的war包中，在lib目录下才不会包含Tomcat相关的jar包，否则将会出现启动错误。
还有一个很关键的关键点，就是tomcat-embed-jasper中scope必须是provided。
1. <dependency> 2. <groupId>org.apache.tomcat.embed</groupId> 3. <artifactId>tomcat-embed-jasper</artifactId> 4. <scope>provided</scope> 5. </dependency>
因为SpringBootServletInitializer需要依赖 javax.servlet，而tomcat-embed-jasper下面的tomcat-embed-core中就有这个javax.servlet，如果没用provided，最终打好的war里面会有servlet-api这个jar，这样就会跟tomcat本身的冲突了。
这个关键点同样适应于下面说的第二种方法。
方法二：
直接添加如下配置即可：
spring-boot-starter-tomcat是Spring Boot默认就会配置的，即Spring Boot的内嵌tomcat，将其设置为provided是在打包时会将该包(依赖)排除，因为要放到独立的tomcat中运行，Spring Boot内嵌的Tomcat是不需要用到的。
<!--部署成war包时开启【同时支持war和jar启动部署】↓↓↓↓--> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <scope>provided</scope> </dependency> <dependency> <groupId>org.apache.tomcat.embed</groupId> <artifactId>tomcat-embed-jasper</artifactId> <scope>provided</scope> </dependency> <!--部署成war包时开启【同时支持war和jar启动部署】↑↑↑↑-->
provided的作用上面已经介绍的很透彻了，这里就不啰嗦了，
这种方式的好处是，打包的war包同时适合java -jar命令启动以及部署到外部容器中。
3、由jar变成war
<packaging>war</packaging>
4、注意的问题
4.1、项目名称和打包名称的一致性
此时打成的包的名称应该和application.properties的
server.context-path=/sdk-cms
注意SpringBooot2.x，这里的写法为 server.servlet.context-path=
保持一致
<build> <finalName>sdk-cms</finalName> </build>
如果不一样发布到tomcat的webapps下上下文会变化
4.2、Tomcat的版本
SpringBoot2.x，请使用Tomcat8.5以上的版本
SpringBoot2.1.2默认Tomcat的版本是9.0.14
SpringBoot1.5.6默认Tomcat的版本是8.5.16
4.3、Error assembling WAR: web.xml attribute is required
Failed to execute goal org.apache.maven.plugins:maven-war-plugin:2.2:war (default-war)
on project XXX: Error assembling WAR: web.xml attribute is required (or pre-existing WEB-INF/web.xml if executing in update mode)
这个提示并不是你缺少依赖,而是在打包的时候,没有web.xml文件,因为SpringCloud 微服务多模块下没有web.xml文件,此时也不需要加入,在pom文件下加入一行代码如下:
<!--如果想在没有web.xml文件的情况下构建WAR，请设置为false。--> <properties> <failOnMissingWebXml>false</failOnMissingWebXml> </properties>
