如何将spring boot项目打包成war包,并部署在tomcat上运行

  • 一·修改打包方式:
  • 二·移除spring boot自带的嵌入式tomcat插件:
  • 三·添加servlet-api的依赖:若你整合了servlet程序,就需要导入依赖,以下三个任选一个(没有整合就可以跳过)
  • 四·添加war包的名称:
  • 五·若springboot项目中若有jsp页面,必须手动指定最后编译的路径:(没有整合就可以跳过)
  • 六·修改启动类,并重写初始化方法:
  • 七·打包部署:
  • 八·测试结果,启动tomcat,再访问相关页面:


一·修改打包方式:

<packaging>war</packaging>

二·移除spring boot自带的嵌入式tomcat插件:

<!--        配置springboot框架的起步依赖-->
        <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>

三·添加servlet-api的依赖:若你整合了servlet程序,就需要导入依赖,以下三个任选一个(没有整合就可以跳过)

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>org.apache.tomcat</groupId>
    <artifactId>tomcat-servlet-api</artifactId>
    <version>8.0.36</version>
    <scope>provided</scope>
</dependency>
<!--   引入springboot框架中内嵌的tomcat,去解析jsp依赖-->
<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-jasper</artifactId>
    <scope>provided</scope>
</dependency>

注意:< scope>provided< /scope>一定不能少,否则后面就会出问题,tomcat无法解析jsp

四·添加war包的名称:

<finalName>springboot</finalName>

五·若springboot项目中若有jsp页面,必须手动指定最后编译的路径:(没有整合就可以跳过)

<resource>
       <!--源文件位置-->
           <directory>src/main/web</directory>
       <!--指定编译到 META-INF/resources,该目录不能随便写-->
           <targetPath>META-INF/resources</targetPath>
       <!--指定要把哪些文件编译进去,**表示 webapp 目录及子目录,*.*表示所有文件-->
           <includes>
                <include>*.*</include>
           </includes>
</resource>
<!--    把src/main/resources 下的所有配置文件编译到 classes 下面去-->
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.*</include>
                </includes>
            </resource>
<!--src/main/java下的 mybatis 的 mapper.xml ,以及所有配置文件编译到 classes 下面去:需要才添加-->
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.xml</include>
                </includes>
            </resource>

原因:
1. springboot项目默认推荐使用前端引擎是thymeleaf;
要使用springboot集成jsp,需要手动指定最后编译的路径;
而且springboot集成jsp编译jsp的路径是springboot规定好的位置META-INF/resources

2. SpringBoot 要求 jsp 文件必须编译到指定的 META-INF/resources 目录下才能访问,否则访问不到。其它官方已经建议使用模版技术

六·修改启动类,并重写初始化方法:

1.一般web项目,只在idea上面运行时,启动类的写法如下:

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

2.若需要将web项目打包成war包,且部署到tomcat上面运行时,启动类必须包含如下内容,也可再添加其他正常注解,方法调用等等:

/**
 * 修改启动类,继承 SpringBootServletInitializer 并重写 configure 方法
 */
public class SpringBootStartApplication extends SpringBootServletInitializer {

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

七·打包部署:

1.利用maven命令打包

SpringBoot 打包会把nacos上的配置下载下来吗_java


2.将打的war包,复制粘贴到tomcat的webapps目录下(不用解压,启动tomcat自动解压)

SpringBoot 打包会把nacos上的配置下载下来吗_tomcat_02

八·测试结果,启动tomcat,再访问相关页面:

1.在tomcat安装目录下的bin目录下面找到startup.bat命令,启动tomcat

SpringBoot 打包会把nacos上的配置下载下来吗_jsp_03


2.若出现这样的页面表示成功:

SpringBoot 打包会把nacos上的配置下载下来吗_spring boot_04


3.部署到tomcat必须加上项目工程名:具体如下

http://localhost:[端口号]/[打包项目名]/

SpringBoot 打包会把nacos上的配置下载下来吗_tomcat_05


测试成功!

注意:
springboot项目打war包,部署到tomcat中,之前在application.properties文件中设置的上下文根和端口号会失效,要以部署的tomcat为准