通过eclipse把spring boot项目打包成war包并部署到tomcat服务器上的步骤

今天想把spring boot项目部署到安装的tomcat服务器上,现在整理下创建springboot—>打包—>部署—>访问这个整个步骤以及遇到的问题,供参考和以后的回顾:

一、 eclipse创建springboot项目

eclipse已经安装好了sts插件,所以直接创建springboot项目:
在这里插入图片描述
在这里插入图片描述
用到数据库的话勾选jdbc API(不勾选,后面如果用到数据库再自己引入依赖也可以):
在这里插入图片描述
项目创建好后可以删了这3个文件:
在这里插入图片描述
修改启动类,修改启动类,并重写初始化方法(不重写的话没法在Tomcat启动)。因为需要类似于web.xml的配置方式来启动spring上下文了,我将启动引导类整合成了一个HandlerDataApplication类(其实这个是为了方便后续的打包到Tomcat,其实不整合eclipse也能启动springboot):
在这里插入图片描述

@SpringBootApplication
public class HandlerDataApplication extends SpringBootServletInitializer {
    
    

	public static void main(String[] args) {
    
    
		SpringApplication.run(HandlerDataApplication.class, args);
	}
	
	@Override
	protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
    
    
		return application.sources(HandlerDataApplication.class);
	}

}

启动类下一级创建一个HelloController类用于测试:
在这里插入图片描述

端口改成8085,默认是8080:
在这里插入图片描述
右键项目Run As Springboot APP:
在这里插入图片描述
浏览器访问显示页面成功:
在这里插入图片描述

二、将springboot项目打war包并部署至Tomcat

1. 修改打包形式

在pom.xml里设置

packaging>war</packaging>

2.除嵌入式tomcat插件

在pom.xml里找到spring-boot-starter-web依赖节点,在其中添加如下代码,

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <!-- 移除嵌入式tomcat插件 -->
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3.加servlet-api的依赖

下面两种方式都可以,任选其一
方式1、我是用这个

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

方式2、version信息改成对应的tomcat版本信息

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

若想要定义项目打包的名字,加如下配置(我demo没有改成这样)

<build>
    <finalName>project name</finalName>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>

也可以增加springboot的热部署依赖(修改项目中的文件时项目自动重启,不用手动重启)

<!--spring-boot 开始有的热部署功能依赖 hot swapping, disable cache for template, 
			enable live reload -->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-devtools</artifactId>
			<optional>true</optional>
		</dependency>

最后 pom.xml文件内容是这样:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.1.7.RELEASE</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>
	<groupId>com.XXX</groupId>
	<artifactId>HandlerData</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>war</packaging>
	<name>HandlerData</name>
	<description>Demo project for Spring Boot</description>

	<properties>
		<java.version>1.8</java.version>
	</properties>

	<dependencies>
		<!-- 引入Web模块 -->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
			<!-- 移除嵌入式tomcat插件 -->
			<exclusions>
				<exclusion>
					<groupId>org.springframework.boot</groupId>
					<artifactId>spring-boot-starter-tomcat</artifactId>
				</exclusion>
			</exclusions>
		</dependency>
		<dependency>
			<groupId>javax.servlet</groupId>
			<artifactId>javax.servlet-api</artifactId>
			<version>3.1.0</version>
			<scope>provided</scope>
		</dependency>


		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-tomcat</artifactId>
			<scope>provided</scope>
		</dependency>
		<!-- 测试模块,包括JUnit、Hamcrest、Mockito -->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
		<!--spring-boot 开始有的热部署功能依赖 hot swapping, disable cache for template, enable 
			live reload -->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-devtools</artifactId>
			<optional>true</optional>
		</dependency>

	</dependencies>

	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

</project>

4.打包,开始将项目打包成war包。
4.1在Eclipse中右击项目名称,点击“Run As”,然后选择“Maven install”,等待编译成功,编译成功提示后,打开项目的文件夹,找到target目录下就可以看到打成的War包。4.2或者右键项目export导出war包。

在这里插入图片描述
5.部署

把war包放到tomcat的webapps目录下,启动tomcat,即可自动解压部署:(tomcat/bin目录下,双击startup.bat即可启动tomcat,成功启动,自动解压部署运行)。最后在浏览器中输入
http://localhost:[端口号]/[打项目名]/

注意:端口号以tomcat配置时指定的为准,不是springboot中配置的了,项目名称一定要加,即war包的名字,然后才能访问你之前的请求路径

浏览器访问,成功:
在这里插入图片描述
在tomcat下设置默认启动项目的方式,这样可以在访问时不再加项目名称了,参考如下链接:
https://blog.csdn.net/huangyaa729/article/details/84644646

部署到Tomcat遇到一个坑,就是war在Tomcat 7.0.88 版本启动时报错,无法启动。然后又将war放到Tomcat 8.5.34版本也报错。最后百度说好像Tomcat 8.0版本才能启动,于是就去官网下载了Tomcat 8.0.53版本,最后才运行成功,具体原因暂时不明白。

下载旧版本的Tomcat可参考链接:
https://jingyan.baidu.com/article/cd4c29793b293f756f6e6056.html

(下载注意重点:点击左侧的 Tomcat 8 会进入Tomcat 8 的介绍页。通常大家会看到两个版本的链接,单击对应的即可获取相应的版本。本文主要介绍不在此处的版本下载,因此,这两个不是我们的目标。我们需要点击右侧的Archives,进入Tomca 版本库中再进入该版本的bin目录下载,里面有x86、x64的安装版、解压版,选择需要的下载即可!)

猜你喜欢

转载自blog.csdn.net/QRcode_Y/article/details/100123923