springboot项目部署到tomcat步骤以及常见问题

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

------------恢复内容开始------------

本文分为两个部分，一，是打包的步骤，二，是我项目中所遇到的问题以及解决方法

一. 打包为war包步骤

1.修改打包方式为war

在pom.xml文件中将打包格式修改为war格式

2.移除springboot自带的tomcat插件

在pom.xml里找到spring-boot-starter-web依赖节点，将其中包含的tocat去除

<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>

如果在测试时还是想以springboot方式启动，可以再加入依赖，强烈建议该方式

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

3. 添加servlet-api的依赖

以下两种依赖随意添加一个

<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.</version>
<scope>provided</scope>
</dependency>

<dependency>
<groupId>org.apache.tomcat</groupId>
<artifactId>tomcat-servlet-api</artifactId>
<version>8.0.</version>
<scope>provided</scope>
</dependency>

4. 修改启动类，并且重写初始化方法

springboot项目一般都有一个启动类来启动项目，而部署到tomcat不能通过该方式启动，所以需要改变启动方式，在启动类的同级包下添加一个初始化类，并且继承SpringBootServletInitializer

如下：

public class ServletInitializer extends SpringBootServletInitializer {
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
// 注意这里要指向用main方法执行的Application启动类
return builder.sources(VpnManagementSystemApplication.class); }
}

接下来就可以打包成war包部署了，打开命令窗口，选择powershell命令，然后在命令行里输入： mvn clean package即可，然后去项目的目录下的target下就可以看到已经打包好的war包。

二. 常见问题

springboot项目在idea中放在tomcat中也是可以运行的，idea中配置一个tomcat来运行项目，最好和服务器版本一样，测试环境和开发环境一样才好寻找问题解决问题，以下问题都是我遇到的，以及有效的解决方法，可能

对于你的项目来说没用，欢迎讨论。

1.jar包冲突问题

在springboot项目的项目中需要手动添加的一些包可能tomcat已经存在，这时就需要删除这些包，否则就会报错，甚至项目直接启动不起来比如在springboot项目下用jsp页面，这时需要添加的依赖包在

tomcat已经存在，就会报错，如下包

<dependency>
<groupId>org.apache.tomcat.embed</groupId>
<artifactId>tomcat-embed-jasper</artifactId>
</dependency>-->

所以在部署到tomcat报错时，一定要考虑依赖冲突问题。

2.使用pagehelper时，springboot方式启动时正常，放到tomcat出现：“在系统中发现了多个分页插件,请检查系统配置!” 问题

该问题出现的原因在于maven的pagehelper-spring-boot-starter这个依赖，提供了自动配置分页插件的功能，而我们还添加了如下依赖，所以就报错，但是不添加如下依赖项目就直接找不到包，

<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper-spring-boot-starter</artifactId>
<version>1.2.12</version>
</dependency>