Spring boot 打成war包 tomcat部署

本文详细介绍如何将Spring Boot项目修改并配置为WAR包进行部署,包括修改pom.xml文件,调整打包类型,排除嵌入式Tomcat,以及在Tomcat服务器上部署WAR包的具体步骤。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

修改pom.xml

修改打包类型

<packaging>war</packaging>

在“依赖项”部分中,请确保指示提供了tomcat,因此不需要嵌入的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>
		<dependency>
			<groupId>org.apache.tomcat.embed</groupId>
			<artifactId>tomcat-embed-jasper</artifactId>
			<scope>provided</scope>
		</dependency>

修改启动类

package com.nsitd.pms;

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;
import org.springframework.context.annotation.ComponentScan;

import springfox.documentation.swagger2.annotations.EnableSwagger2;

@SpringBootApplication
@EnableSwagger2
@ComponentScan(basePackages = { "com.nsitd" })
public class PmsApp extends SpringBootServletInitializer {
	/**
	 * Used when run as JAR
	 */
	public static void main(String[] args) {
		SpringApplication.run(PmsApp.class, args);
	}

	/**
	 * Used when run as WAR
	 */
	@Override
	protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
		return builder.sources(PmsApp.class);
	}
}

项目部署

maven 打包生成****.war,

  • 第一种情况,配置文件配置了项目路径
 server:
  port: 58035
  servlet: 
    context-path: /pms

修改war包名称与context-path: /pms名称一致。例如这里修改为pms.war。然后将war包放到tomcat的webapp下,启动tomcat。
页面访问 127.0.0.1:8080/pms

  • 第二种情况,配置文件没有配置项目路径,那么默认/
server:
 port: 58035

那这里需要修改tomcat下conf/server.xml
在Host下添加一行,修改默认访问项目名称和项目发布路径,

<Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true">

<Context docBase="ppp" path="" reloadable="true"/>

ppp 为war包名称
war包放到tomcat的webapp下,启动tomcat。
页面访问 127.0.0.1:8080

  • 修改配置

reloadable=true,直接编辑配置配置文件webapp/pms/WEB-INF/classes/application.yml即可,无需重启tomcat

  • 附上完整的pom文件
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>

	<groupId>com.nsitd</groupId>
	<artifactId>nsitd-pms</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>war</packaging>
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.1.3.RELEASE</version>
		<relativePath />
	</parent>
	<name>nsitd-pms</name>
	<url>http://maven.apache.org</url>

	<properties>
		<jar.dic>${project.basedir}/lib</jar.dic>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
		<gdal.version>1.2.0</gdal.version>
		<fastjson.version>1.2.7</fastjson.version>
	</properties>

	<dependencies>
		<!--******************************** 公司内 ********************************* -->
		<!-- <dependency> <groupId>com.nsitd</groupId> <artifactId>SNBP-COMMON</artifactId> 
			<version>0.0.1</version> </dependency> -->
		<dependency>
			<groupId>com.nsitd</groupId>
			<artifactId>sncp-gdal</artifactId>
			<version>${gdal.version}</version>
		</dependency>
		<dependency>
			<groupId>com.nsitd</groupId>
			<artifactId>sncp-ea</artifactId>
			<version>2.0.0</version>
		</dependency>
		<!--******************************** Spring 相关 ********************************* -->
		<!-- 监控系统健康情况 -->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-actuator</artifactId>
		</dependency>
		<!--支持 Web 应用开发,包含 Tomcat 和 spring-mvc。 -->
		<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>
		<dependency>
			<groupId>org.apache.tomcat.embed</groupId>
			<artifactId>tomcat-embed-jasper</artifactId>
			<scope>provided</scope>
		</dependency>
		<!-- 测试 -->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>

		<!--******************************** 数据库相关 ********************************* -->
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<!-- <scope>runtime</scope> -->
		</dependency>

		<dependency>
			<groupId>com.alibaba</groupId>
			<artifactId>druid-spring-boot-starter</artifactId>
			<version>1.1.9</version>
		</dependency>
		<!-- Spring Boot Mybatis 依赖 -->
		<dependency>
			<groupId>org.mybatis.spring.boot</groupId>
			<artifactId>mybatis-spring-boot-starter</artifactId>
			<version>1.2.0</version>
		</dependency>
		<!-- 分页 -->
		<dependency>
			<groupId>com.github.pagehelper</groupId>
			<artifactId>pagehelper-spring-boot-starter</artifactId>
			<version>1.2.10</version>
		</dependency>

		<!-- MQ服务 -->
		<dependency>
			<groupId>com.nsitd.component</groupId>
			<artifactId>JD-Component-MQ</artifactId>
			<version>0.0.8</version>
		</dependency>

		<!--hutool 工具类库 -->
		<dependency>
			<groupId>cn.hutool</groupId>
			<artifactId>hutool-core</artifactId>
			<version>4.6.8</version>
		</dependency>
		<dependency>
			<groupId>com.belerweb</groupId>
			<artifactId>pinyin4j</artifactId>
			<version>2.5.0</version>
		</dependency>
		<!-- gson -->
		<dependency>
			<groupId>com.google.code.gson</groupId>
			<artifactId>gson</artifactId>
		</dependency>
		<dependency>
			<groupId>com.alibaba</groupId>
			<artifactId>fastjson</artifactId>
			<version>${fastjson.version}</version>
		</dependency>



		<!--************************************ 接口文档 相关 ********************************************* -->
		<!-- swagger 接口文档 -->
		<dependency>
			<groupId>io.springfox</groupId>
			<artifactId>springfox-swagger2</artifactId>
			<version>2.8.0</version>
		</dependency>
		<!-- swagger-ui支持 -->
		<dependency>
			<groupId>io.springfox</groupId>
			<artifactId>springfox-swagger-ui</artifactId>
			<version>2.8.0</version>
		</dependency>
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>3.8.1</version>
			<scope>test</scope>
		</dependency>


		<!-- Redis -->
		<dependency>
			<groupId>redis.clients</groupId>
			<artifactId>jedis</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.data</groupId>
			<artifactId>spring-data-redis</artifactId>
		</dependency>
		<!-- 自启动 -->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-devtools</artifactId>
			<optional>true</optional>
			<scope>true</scope>
		</dependency>
	</dependencies>
	<build>
		<resources>
			<resource>
				<directory>${basedir}/src/main/webapp</directory>
				<!--注意此次必须要放在此目录下才能被访问到 -->
				<targetPath>META-INF/resources</targetPath>
				<includes>
					<include>**/**</include>
				</includes>
			</resource>
			<resource>
				<directory>${basedir}/src/main/resources</directory>
				<includes>
					<include>**/**</include>
				</includes>
			</resource>
		</resources>
		<plugins>
			<plugin>
				<artifactId>maven-compiler-plugin</artifactId>
				<configuration>
					<source>1.8</source>
					<target>1.8</target>
				</configuration>
			</plugin>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
				<configuration>
					<!-- fork : 如果没有该项配置,肯呢个devtools不会起作用,即应用不会restart -->
					<fork>true</fork>
					<executable>true</executable>
				</configuration>
			</plugin>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
				<configuration>
					<mainClass>com.nsitd.pms.PmsApp</mainClass>
				</configuration>
				<executions>
					<execution>
						<goals>
							<goal>repackage</goal>
						</goals>
					</execution>
				</executions>
			</plugin>
		</plugins>
	</build>
</project>

<think>好的,我现在需要帮助用户了解如何将Spring Boot应用打WAR文件,并在引入外部配置文件后部署Tomcat服务器。首先,我得回忆一下相关的步骤,确保每个环节都正确无误。 首先,用户的问题涉及几个关键点:打WAR、引入外部配置文件、部署Tomcat。我需要按照这些点逐一解答。根据之前的引用内容,用户可能遇到404错误,可能是因为没有正确配置启动类或依赖项。 第一步,修改启动类。记得Spring Boot应用默认打成JAR,如果要改成WAR,需要继承SpringBootServletInitializer并重写configure方法。引用[1]、[2]、[4]都提到了这一点,必须确保用户正确修改启动类,否则部署时可能无法正确初始化应用。 接下来是pom.xml的配置。需要将打方式改为war,添加servlet-api依赖,并排除内嵌的Tomcat。这里需要注意,有时候用户可能会忘记排除内嵌的Tomcat,导致冲突。引用[1]、[3]提到要排除内嵌Tomcat,并将其作用域设为provided,这样打时就不会含它了。不过引用[3]的注释说可能不需要排除,但根据其他引用,最好还是排除,避免潜在问题。 然后是外部配置文件。用户可能需要将application.properties或application.yml放在外部,比如Tomcat的conf目录下,或者通过JVM参数指定路径。引用[5]提到将配置文件放在WAR外面,这样可以方便修改而不需要重新打。需要告诉用户如何配置spring.config.location,使用环境变量或启动参数来指定外部文件的位置。 在部署Tomcat时,可能需要将WAR文件放在webapps目录下,并确保Tomcat版本兼容。还要提醒用户注意可能遇到的常见问题,比如访问404,这时候要检查启动类是否正确,依赖是否排除干净,以及配置文件路径是否正确。 最后,生成相关问题,帮助用户进一步深入。例如如何指定不同环境的配置文件,或者如何处理多模块项目的打问题。这些都是用户可能遇到的后续问题。 现在需要把这些步骤整理成一个清晰的教程,确保用户能够一步步操作,并避免常见的错误点。同时,引用相关的引用来源,增强可信度。例如,在修改启动类的时候引用[1]和[4],在配置pom.xml时引用[3],在外部配置文件部分引用[5]。 需要检查是否有遗漏的步骤,比如测试是否成功,或者是否需要配置Tomcat的其他参数。确保每个步骤都有对应的解决方案,并给出示例代码,比如启动类的代码和pom.xml的依赖配置,这样用户可以直接复制粘贴,减少出错的可能。 另外,可能还需要提醒用户关于Tomcat的版本兼容性问题,比如Spring Boot 2.x可能需要Tomcat 8.5或更高版本。还有,如果使用Java 11,需要注意Tomcat的兼容性。不过用户的问题中没有提到版本,可能需要保持通用性,只讲一般步骤,不涉及具体版本。 总结一下,整个流程应该是:修改启动类 → 配置pom.xml → 打WAR → 处理外部配置文件 → 部署Tomcat → 验证和测试。每个步骤都需要详细说明,并附上示例代码和配置,确保用户能顺利操作。</think>### 如何将Spring Boot应用打WAR文件并引入外部配置文件部署Tomcat? 以下是分步操作指南,结合代码示例和配置文件调整: --- #### **一、修改启动类** Spring Boot默认生成可执行JAR,需通过以下改造支持WAR部署: ```java @SpringBootApplication public class Application extends SpringBootServletInitializer { // 继承SpringBootServletInitializer @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) { return builder.sources(Application.class); // 指定启动类[^1][^2][^4] } public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` --- #### **二、配置pom.xml** 1. **修改打格式**: ```xml <packaging>war</packaging> <!-- 指定打WAR --> ``` 2. **排除内嵌Tomcat并添加依赖**: ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <scope>provided</scope> <!-- 依赖由外部Tomcat提供[^3] --> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <scope>provided</scope> </dependency> ``` --- #### **三、打生成WAR文件** 在项目根目录执行Maven命令: ```bash mvn clean package ``` 生成的WAR文件位于`target`目录下,文件名为`项目名-版本.war`。 --- #### **四、引入外部配置文件** **方法1:通过环境变量指定外部路径** 启动时添加参数: ```bash java -jar your-app.war --spring.config.location=/path/to/external/config/ ``` **方法2:配置文件优先级** Spring Boot默认按以下顺序加载配置文件[^5]: 1. `./config/`(项目根目录下的`config`文件夹) 2. `./`(项目根目录) 3. `classpath:/config/` 4. `classpath:/` 将`application.properties`或`application.yml`放在Tomcat的`conf`目录或WAR同级`config`目录即可。 --- #### **五、部署Tomcat** 1. 将WAR文件复制到Tomcat的`webapps`目录。 2. 启动Tomcat(执行`bin/startup.sh`或`bin/startup.bat`)。 3. 访问路径:`http://localhost:8080/your-war-name/`。 --- #### **常见问题排查** - **404错误**:检查启动类是否继承`SpringBootServletInitializer`[^2]。 - **依赖冲突**:确认已排除内嵌Tomcat(`<scope>provided</scope>`)[^3]。 - **配置未生效**:检查外部配置文件路径是否正确。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值