SpringBoot应用部署到外部Tomcat
Posted 不知道取什么名的鬼鬼
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了SpringBoot应用部署到外部Tomcat相关的知识,希望对你有一定的参考价值。
一、前言
SpringBoot内置tomcat使用很方便,打包成可执行jar文件后可以直接运行,然后内置Tomcat配置终究没有外部独立Tomcat方便,并且如果有多个web应用,使用外部独立Tomcat管理起来也更加方便。因此,这边文章介绍一下本人将myblog应用部署到外部Tomcat的过程以及其中遇到的一些问题与解决方法。
二、打包成可部署到Tomcat的war包
将应用打成war包,需要进行以下几个步骤:
1.修改打包形式
将原来的jar打包形式<packaging>jar</packaging>
改成war打包形式<packaging>war</packaging>
。打jar包的插件仍然可以保留,不冲突。
2.移除嵌入式tomcat插件
在pom.xml里找到spring-boot-starter-web依赖节点,在其中添加如下代码:
1 <dependency> 2 <groupId>org.springframework.boot</groupId> 3 <artifactId>spring-boot-starter-web</artifactId> 4 <!-- 移除嵌入式tomcat插件 --> 5 <exclusions> 6 <exclusion> 7 <groupId>org.springframework.boot</groupId> 8 <artifactId>spring-boot-starter-tomcat</artifactId> 9 </exclusion> 10 </exclusions> 11 </dependency>
3.将Tomcat依赖修改为本地调试模式
为了本地调试方便,在pom.xml文件中,dependencies下面的tomcat依赖修改为:
1 <dependency> 2 <groupId>org.springframework.boot</groupId> 3 <artifactId>spring-boot-starter-web</artifactId> 4 <exclusions> 5 <exclusion> 6 <groupId>org.springframework.boot</groupId> 7 <artifactId>spring-boot-starter-tomcat</artifactId> 8 </exclusion> 9 </exclusions> 10 </dependency>
4.修改启动类
常规Springboot应用启动类为Application:
1 package com.guigui.blog; 2 import org.springframework.boot.SpringApplication; 3 import org.springframework.boot.autoconfigure.SpringBootApplication; 4 import org.springframework.cache.annotation.EnableCaching; 5 import org.springframework.transaction.annotation.EnableTransactionManagement; 6 @SpringBootApplication 7 @EnableTransactionManagement 8 @EnableCaching 9 public class Application { 10 public static void main(String[] args) { 11 SpringApplication.run(Application.class, args); 12 } 13 }
我们需要类似于web.xml的配置方式来启动spring上下文,在Application类的同级添加一个SpringBootStartApplication类,其代码如下:
1 package com.guigui.blog; 2 import org.springframework.boot.builder.SpringApplicationBuilder; 3 import org.springframework.boot.web.support.SpringBootServletInitializer; 4 /** 5 * 修改启动类,继承 SpringBootServletInitializer 并重写 configure 方法 6 */ 7 public class SpringBootStartApplication extends SpringBootServletInitializer { 8 @Override 9 protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) { 10 // 注意这里要指向原先用main方法执行的Application启动类 11 return builder.sources(Application.class); 12 } 13 }
5.打包部署
在项目根目录下(即包含pom.xml的目录),在命令行里输入:
1 mvn clean package
即可, 等待打包完成,出现[INFO] BUILD SUCCESS即为打包成功。然后把target目录下的war包放到tomcat的webapps目录下,启动tomcat,即可自动解压部署。 最后在浏览器中输入:
http://localhost:[端口号]/[打包项目名]/
发布成功。
三、遇到问题
1.访问路径问题
部署到外部tomcat之后,请求的URL需要在端口号加上项目名才可以正常访问,这样页面中各种资源的访问都需要加上相应的项目名称,为了保证常规Springboot应用访问资源也不会出现问题,需要将Springboot应用配置为带项目名前缀访问,application.yml文件改动:
1 server: 2 context-path: /myblog
这样两种方式的请求URL就是一样的了。
由于项目名称通过具体的部署情况,名称可能不一样,所以在js或者ftl等页面文件中使用的项目名称不能写死,需要动态获取,下面给出js和ftl文件动态获取项目名称方式:
- 1.ftl获取当前项目名称:
1 <#assign basePath=request.contextPath> 2 <!-- 具体使用 --> 3 <link href="${basePath}/vendor/admin/bootstrap/css/bootstrap.min.css" rel="stylesheet">
- 2.js中获取当前项目名称:
1 function getRootPath() { 2 var strPath = window.document.location.pathname; 3 var postPath = strPath.substring(0, strPath.substr(1).indexOf(‘/‘) + 1); 4 return postPath; 5 }
2.字体资源无法访问导致icon图标显示失败问题
Spring Boot + Bootstrap 出现"Failed to decode downloaded font"和"OTS parsing error: Failed to convert W
错误。导致所有图标显示不出。
通过各种百度和Google搜索,找到原因:
因为经过maven的filter,会破坏font文件的二进制文件格式,到时前台解析出错。
解决方案:
设置filter,font文件不需要filter,具体pom文件配置如下:
1 <resource> 2 <directory>src/main/resources</directory> 3 <targetPath>${basedir}/target/classes</targetPath> 4 <filtering>true</filtering> 5 <excludes> 6 <exclude>static/vendor/**/fonts/**</exclude> 7 </excludes> 8 </resource> 9 <resource> 10 <directory>src/main/resources</directory> 11 <targetPath>${basedir}/target/classes</targetPath> 12 <filtering>false</filtering> 13 <includes> 14 <include>static/vendor/**/fonts/**</include> 15 </includes> 16 </resource>
重新编译整个工程,解决问题。
以上是关于SpringBoot应用部署到外部Tomcat的主要内容,如果未能解决你的问题,请参考以下文章
将启用 SSL 的 Java SpringBoot 战争部署到外部 Tomcat 服务器
Spring Boot在部署到Tomcat期间无法加载外部jar
将 Spring Boot 应用程序部署到外部 tomcat 服务器时,通过 application.properties 更改其端口