以下解决方式适用于跟我类似的配置环境，构建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”文本。

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudyec234c79-f36d-4e28-9397-116e38470c11.png)
![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudy230a74e4-a7de-425c-8022-015bdd485e29.png)

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

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudyd8984b53-4824-40f6-889d-9f72cbeb6901.png)

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

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudy7cd6f305-6268-40f7-9db7-88ded05f8e82.png)

这......，不是一个servlet类？？？，回去跟了跟代码，确定没写错啊，要不百度吧，看看网上怎么说。
哦，原来是导入的Servlet-api包与tomcat冲突，tomcat自带了jar包，需要在自己导入的jar包上添加作用域。原来如此那么咱也加上，这不很简单，小意思。

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudy28178824-245d-4294-a7f4-580f0caaf46f.png)

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

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudy0383270f-e752-48ab-9ff1-04a2f79c2a8b.png)

这怎么跟刚才的错误还不一样，实例化Servlet类异常，说是找不到javax/servlet/http/HttpServlet，我明明导入了jar包啊，也加了作用域了，难道我用的新版兼容性不好？？？  
于是我想，要不不用maven依赖导包了，我自己建了一个lib目录，把servlet-api包放到里面，然后再引用自己的包。  
然后再次运行，输入/hello

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudyaa20cc60-becc-451b-818d-085a11351fec.png)

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

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudyc395e7ae-73ea-46b4-a60e-78d7641607ad.png)

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

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

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudy0b114e02-1569-43d1-98e0-a351ebc5bb0f.png)

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudy74201900-527c-47cc-8774-25b5bccfa017.png)

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

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudy4dfc8589-0e4d-4358-a84e-cb7ae2c07adb.png)

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

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudyab556606-002b-464c-810c-43a93a5923f5.png)

咦？这不有HttpServlet吗？为啥刚才给我爆红，思考了三秒钟。。。不管了，先跑起来再说。  
撸完了代码，重新启动，抱着最后的希望，输入/hello（说实话，在输入的过程中，我向上帝祈祷了。。。）

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudyabb2ec67-8f21-41ea-b16a-b9ed95ae3e35.png)

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

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

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

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudyba33faff-460d-47a1-8ac7-7549b948d1d2.png)

这两个包的包名不一致

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudyd2b671ac-53b1-478e-ad6b-b147c13900a9.png)

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

![](https://kuangstudy.oss-cn-beijing.aliyuncs.com/bbs/2021/03/16/kuangstudydd2b8c4c-fc5e-4569-854a-fd6c386727ff.png)

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

## 解决方法

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

1. 降Tomcat版本，降到9版本的。
2. 不用降版本，不要使用maven导入的servlet-api包，在F4的项目模块中引入Tomcat依赖，操作步骤在上面有说明。
   
这只是我自己的解决方式，如果哪位小伙伴有更好的方式，也可以在评论区留言。

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

总共已有 0 条评论