记一次maven jar包冲突的排查和解决过程，干货分享

一、背景

项目新拉了一个分支开发，前几天好好的，加了一些功能后发现部署一直失败。

总是报同一个错误（详见2.1），而且并不像是自己代码的错误。

和同事花费了一些时间进行排查，最终定位并解决问题，记下分析思路。

二、排查步骤

注：截图均来自自己的本地练习项目，而不是排查一模一样的截图，只是演示效果。

2.1报错内容

java.util.concurrent.ExecutionException: org.apache.catalina.LifecycleException: Failed to start component [StandardEngine[Tomcat].StandardHost[localhost].TomcatEmbeddedContext[]]

       at java.util.concurrent.FutureTask.report(FutureTask.java:122)

       at java.util.concurrent.FutureTask.get(FutureTask.java:192)

       at org.apache.catalina.core.ContainerBase.startInternal(ContainerBase.java:941)

       at org.apache.catalina.core.StandardHost.startInternal(StandardHost.java:872)

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

       at org.apache.catalina.core.ContainerBase$StartChild.call(ContainerBase.java:1421)

       at org.apache.catalina.core.ContainerBase$StartChild.call(ContainerBase.java:1411)

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

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

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

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

Caused by: org.apache.catalina.LifecycleException: Failed to start component [StandardEngine[Tomcat].StandardHost[localhost].TomcatEmbeddedContext[]]

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

       ... 6 common frames omitted

Caused by: org.apache.catalina.LifecycleException: Failed to start component [Pipeline[StandardEngine[Tomcat].StandardHost[localhost].TomcatEmbeddedContext[]]]

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

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

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

       ... 6 common frames omitted

Caused by: org.apache.catalina.LifecycleException: Failed to start component [org.apache.catalina.authenticator.NonLoginAuthenticator[]]

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

       at org.apache.catalina.core.StandardPipeline.startInternal(StandardPipeline.java:182)

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

       ... 8 common frames omitted

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

       at org.apache.catalina.authenticator.AuthenticatorBase.startInternal(AuthenticatorBase.java:1186)

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

       ... 10 common frames omitted

2019-05-28 11:30:28.605  WARN 25 --- [main]  ationConfigEmbeddedWebApplicationContext : Exception encountered during context initialization - cancelling refresh attempt: org.springframework.context.ApplicationContextException: Unable to start embedded container; nested exception is org.springframework.boot.context.embedded.EmbeddedServletContainerException: Unable to start embedded Tomcat

2019-05-28 11:30:28.640 ERROR 25 --- [main]  o.s.boot.SpringApplication               : Application startup failed

org.springframework.context.ApplicationContextException: Unable to start embedded container; nested exception is org.springframework.boot.context.embedded.EmbeddedServletContainerException: Unable to start embedded Tomcat

       at org.springframework.boot.context.embedded.EmbeddedWebApplicationContext.onRefresh(EmbeddedWebApplicationContext.java:137)

       at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:537)

       at org.springframework.boot.context.embedded.EmbeddedWebApplicationContext.refresh(EmbeddedWebApplicationContext.java:122)

       at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:693)

       at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:360)

       at org.springframework.boot.SpringApplication.run(SpringApplication.java:303)

2.2 尝试

第一反应是给出的错误信息非常不明确，就是说tomcat启动失败。

(1) 由于这个项目是一个maven项目，直接用maven编译命令查看是否可以编译成功，发现都SUCCESS.

(2) 尝试把代码发布到不同的环境，查看是否是环境造成的，发布到了其他环境上，偶尔能成功，发布master都成功，排除了环境bug。

(3) 在google上搜报错信息,大多数提示是servlet-api的jar包冲突。

然后使用mvn dependency:tree 查看依赖树，发现新引入的几个jar包其中有一部分确实包含了servlet-api。

然修改pom.xml文件，排除servelt-api相关依赖。

发现依旧报错。

(4) 由于新增了多个jar包不确定是哪个jar包引起的，因此基于这个分支新拉出一个分支用于删除依赖排错。

删除最可以的新的jar包以及相关的本地代码，重新部署，发布成功。

然后定位到此jar包的servlet-api是通过jboss的包引入的。

由于这是第二方的dubbo的调用api jar包，因此可以放心去掉jboss。

直接排除了jboss的依赖。

————————————————

版权声明：本文为CSDN博主「明明如月学长」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。

原文链接：https://blog.csdn.net/w605283073/article/details/90648055