Servlet学习之Maven导入Servlet-api包与Tomcat冲突报500问题

Maven导入Servlet-api包导致无法运行报500的问题

以下解决方式适用于跟我类似的配置环境，构建servlet程序后，启动Tomcat页面报“类com.tioxy.servlet.MyServlet不是Servlet，MyServlet cannot be cast to class jakarta.servlet.Servlet”或者“实例化Servlet类异常”的500错误的问题。

我的本机配置环境：

1.IDEA 2020.1，Tomcat 10.0.0M5，Maven 3.6.3，导入的javax.servlet-api 4.0.1

最近在学习Java Servlet,并用Maven构建的模板，导入servlet-api依赖包，写了一个简单的Servlet程序，就是很简单的重写doGet、doPost，向页面输出一段“hello,servlet”文本。

然后配置Tomcat服务器，跑起来控制台输出也正常，一切看起来似乎没什么问题，心想servlet构建起来也不过如此嘛！

当我输入/hello,准备见证奇迹时......

这......，不是一个servlet类？？？，回去跟了跟代码，确定没写错啊，要不百度吧，看看网上怎么说。

哦，原来是导入的Servlet-api包与tomcat冲突，tomcat自带了jar包，需要在自己导入的jar包上添加作用域。原来如此那么咱也加上，这不很简单，小意思。

重新启动，重新输入/hello,正要准备结束一切，迎接结果时

这怎么跟刚才的错误还不一样，实例化Servlet类异常，说是找不到javax/servlet/http/HttpServlet，我明明导入了jar包啊，也加了作用域了，难道我用的新版兼容性不好？？？

于是我想，要不不用maven依赖导包了，我自己建了一个lib目录，把servlet-api包放到里面，然后再引用自己的包。

然后再次运行，输入/hello

这怎么又回到第一个错误了，心情有点烦，这么简单的都跑不起来，开始怀疑智商......然后检查生成的target目录

这也没毛病啊，于是这样反复两小时，发现不加依赖包作用域，生成的target包lib目录下有servlet-api包，加了作用域，反而没了，于是我加了作用域，在F4模块构件时添加servlet-api包，试了几次还是不行，顿时心态炸了，这么简单的玩意都搞不定，开始怀疑人生。

我又开始想，既然tomcat自带了jar包，那我直接选用tomcat依赖不就行了。

点击应用后，发现程序爆红了

玩我呢，我这不添加依赖了吗，而且还是tomcat自带的依赖。于是我删掉，重新写了一遍类

咦？这不有HttpServlet吗？为啥刚才给我爆红，思考了三秒钟。。。不管了，先跑起来再说。

撸完了代码，重新启动，抱着最后的希望，输入/hello（说实话，在输入的过程中，我向上帝祈祷了。。。）

嚯，终于通了，留下了激动的泪水，看了看表，距离我第一次启动已经过去三个小时了，跑个程序是真不容易啊，简直是玩命啊！！！，怀疑的我差点想放弃了。

成功是成功了，但是咱要分析问题，这次为什么能成功呢？还记得上面有个小疑问，为啥导入tomcat依赖，程序报错，我自己手写了一遍，发现是能索引出来HttpServlet的这个类。

经过反复的重试，我重新导入maven依赖包，这次tomcat与maven的两个包同时存在。果真，真发现了猫腻：

这两个包的包名不一致

重新看了第一次报错500的原因,注意标注的位置，人家报的是找不到jakarta.servlet.Servlet。

于是大概明白了，Tomcat10竟然改包名了。在tomcat运行的时候，首先会加载tomcat自带的servlet-api包，因为自己导入的包名与tomcat自带的不一致，所以一致报错500，真相大白！

解决方法

看了这么长苦逼的操作，总算是解决了问题，那么同样问题的小伙伴该怎么解决呢，我提供了两种方案：

1. 降Tomcat版本，降到9版本的。
2. 不用降版本，不要使用maven导入的servlet-api包，在F4的项目模块中引入Tomcat依赖，操作步骤在上面有说明。

这只是我自己的解决方式，如果哪位小伙伴有更好的方式，也可以在评论区留言。