springboot项目打包、部署Tomcat流程详解

项目打包
1.移除springboot内置tomcat，在pom文件中找到spring-boot-starter-web依赖，替换成以下依赖。（仅在项目打包时移除内置tomcat）

<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>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <!-- provided代表该依赖参与编译和运行，打包的时候排除该依赖 -->
    <!-- 默认为compile代表后续运行，测试，打包都会被包含进去-->
    <!-- 默认为runntime代表只有运行会被包含进去-->
    <!-- 默认为system代表从本地文件系统获取依赖，配合systempath使用-->
    <scope>provided</scope>
</dependency>

 

2.启动类继承SpringBootServletInitializer

 

 

3.修改pom文件的打包类型（jar、war）

 

 

4.使用maven管理生命周期中的clean和package打包项目（这里演示的是单模块项目）

 

 

打包过程中，就会出现下列错误。

Execution repackage of goal org.springframework.boot:spring-boot-maven-plugin:2.4.1:repackage failed: Unable to find main class
错误原因：使用maven提供spring boot的打包插件spring-boot-maven-plugin情况下，该插件会寻找项目中的主方法入口，但是在刚刚继承SpringBootServletInitializer类时，我们注释掉了主方法入口，所以导致打包失败。

解决方法：
1.使用普通的maven项目打包插件同时注释掉springboot项目的打包插件。

<plugin>

                <groupId>org.apache.maven.plugins</groupId>

                <artifactId>maven-war-plugin</artifactId>

                <version>3.0.0</version>

                <configuration>

                <!-- 打包时监测是否有web.xml文件，当为true时，项目可能会因为没有web.xml文件部署失败，这里关掉监测 -->

                    <failOnMissingWebXml>false</failOnMissingWebXml>

                    <warName>${project.artifactId}</warName>

                </configuration>

            </plugin>

 

2.springboot启动类取消继承SpringBootServletInitializer同时在同级下创建Xxx（Xxx为项目名，就是你springboot启动类Application前面的项目名称）ServletIntializer类继承SpringBootServletInitializer，这样就既有主方法入口，也有SpringBootServletInitializer在外置的Tomcat服务器中映射路径。

 

 

打包成功后，可以在target文件夹下找到对应的jar包或者war包。

 

 

接下来开始部署war包。（如果是jar包，则打开命令行窗口，进入jar所在文件位置输入并执行java -jar 包名.jar就可以运行了）

部署流程
1.首先打开本地的tomcat所在文件地址，找到webapps文件夹，将打包好的war粘贴到webapps文件夹中

 

 

 

 

 

 

 

2.然后进入bin文件夹中找到startup.bat文件，双击运行或者右键管理员运行。

 

 

 

 

 

访问项目，正常访问即部署成功
部署问题集合(重要)
1.明明startup启动tomcat成功，war包也成功被编译，为什么访问对应路径或者接口会出现http404错误，该资源不存在或者没有权限访问。
原因：开发中，如果我们在项目的properties文件或者yml文件设置了项目的根路径或者端口号，用idea中的tomcat服务去运行项目，那么访问路径就是localhost:+配置文件中的端口号（默认80）+配置文件中的项目根路径（默认为/），所以当我们设置了端口号为8080，项目根路径为/xx时，那么我们访问资源的所有地址前面都要加上http://localhost:8080/xx+(/…我们的访问路径)，遵守的是项目配置文件的规则。但是，如果打包成war包放在Tomcat上运行时，项目配置文件中的端口和根路径会失效。遵守的规则则是tomcat的bin目录下server.xml文件中的配置。项目根路径则是对应war包的包名。
所以，当使用tomcat的startup去启动项目或者注册成服务启动项目时，我们访问的路径应该为http://localhost:+(tomcat配置文件的端口号，默认8080)+(项目根路径，则是/加上war包名)
例如：
博主本机的是没改动的，端口号为8080。项目根路径则为war包的包名

 

 

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