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

最新推荐文章于 2024-08-13 17:21:19 发布

筱小虾米

最新推荐文章于 2024-08-13 17:21:19 发布

阅读量1.6k

点赞数

分类专栏：问题处理 Tomcat springboot 文章标签： Tomcat SpringBoot

本文链接：https://blog.csdn.net/qrcode_y/article/details/100123923

版权

问题处理同时被 3 个专栏收录

5 篇文章 0 订阅

订阅专栏

Tomcat

4 篇文章 0 订阅

订阅专栏

springboot

4 篇文章 0 订阅

订阅专栏

今天想把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的安装版、解压版，选择需要的下载即可！）