springboot 内置tomcat 启动报错的 解决方案

问题描述

本地Tomcat项目启动，发现没问题。但是部署到服务器上的Tomcat以后， 发现无法启动，错误如下：

org.apache.catalina.LifecycleException: Failed to start component [StandardEngine[Catalina].StandardHost[localhost].StandardContext[

/report]]

at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:153)

at org.apache.catalina.core.ContainerBase.addChildInternal(ContainerBase.java:899)

at org.apache.catalina.core.ContainerBase.addChild(ContainerBase.java:875)

at org.apache.catalina.core.StandardHost.addChild(StandardHost.java:652)

at org.apache.catalina.startup.HostConfig.deployWAR(HostConfig.java:1092)

at org.apache.catalina.startup.HostConfig$DeployWar.run(HostConfig.java:1984)

at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:471)

at java.util.concurrent.FutureTask.run(FutureTask.java:262)

at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145)

at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615)

at java.lang.Thread.run(Thread.java:745)

Caused by: java.lang.NoSuchMethodError: javax.servlet.ServletContext.getVirtualServerName()Ljava/lang/String;

at org.apache.tomcat.websocket.server.WsServerContainer.<init>(WsServerContainer.java:150)

at org.apache.tomcat.websocket.server.WsSci.init(WsSci.java:131)

at org.apache.tomcat.websocket.server.WsSci.onStartup(WsSci.java:47)

at org.apache.catalina.core.StandardContext.startInternal(StandardContext.java:5573)

at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:147)

... 10 more

明显不是应用代码错误，猜想应该是环境问题。 我本地的Tomcat版本是8.0.28， 而服务器上的Tomcat是7.0.69。 我在本地下了个Tomcat7.0.70部署也报同样错误。更加确定问题跟Tomcat版本有关。查找资料发现，SpringBoot默认Servlet容器是基于Tomcat8的

在打好的war包中确实发现了Tomcat相关jar包，而且是Tomcat8的，拿Tomcat8的embed包在Tomcat7下面那肯定是不能用啊 

要支持低版本Tomcat需要在maven中指定Tomat版本，配置如下：

<properties>

<tomcat.version>7.0.69</tomcat.version>

</properties>

然后依赖中加上

<dependency>

<groupId>org.apache.tomcat</groupId>

<artifactId>tomcat-juli</artifactId>

<version>${tomcat.version}</version>

</dependency>

加上以后试了下，果然是没问题了。看了下war包中的lib目录，确实已经变成Tomcat7的包了 

 既然是由于SpringBoot内部的Servlet容器造成了这个限制， 那就不用了，方法如下

<!-- 打war包时加入此项， 告诉spring-boot tomcat相关jar包用外部的，不要打进去 -->

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-tomcat</artifactId>

<scope>provided</scope>

</dependency>

 

 

总结下SpringBoot应用部署到Tomcat下的配置方法：

1. 将打包方式改成war 
   这个没啥好说的， 肯定要改成war

2. 配置嵌入Tomcat中的方式 
   这里有两种方式可选择：

   方式一：用spring-boot内置的tomcat库， 并指定你要部署到Tomcat的版本

   <properties>
   
   <tomcat.version>7.0.69</tomcat.version>
   
   </properties>
   
   <dependency>
   
   <groupId>org.apache.tomcat</groupId>
   
   <artifactId>tomcat-juli</artifactId>
   
   <version>${tomcat.version}</version>
   
   </dependency>

   方式二：不用spring-boot内置的tomcat库

<!-- 打war包时加入此项， 告诉spring-boot tomcat相关jar包用外部的，不要打进去 -->

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-tomcat</artifactId>

<scope>provided</scope>

</dependency>