Tomcat部署SpringBoot+Camel的WAR包出现CamelServlet类转换异常如何解决

问题根本原因 #

该报错是Servlet API命名空间不兼容导致的：
Tomcat 10.x基于Jakarta EE 9+标准，所有Servlet API的包名从旧版的javax.servlet调整为jakarta.servlet；而你使用的Camel 3.8版本的camel-servlet组件仍基于旧的javax.servletAPI开发，因此在Tomcat 10中加载时会出现类型转换失败。
使用java -jar运行正常是因为Spring Boot内嵌的Servlet容器默认适配javax.servlet命名空间，和现有依赖版本匹配。

可行解决方案 #

方案1：降级Tomcat版本（改造成本最低）

直接将部署用的Tomcat版本替换为9.x系列即可：

• Tomcat 9仍然使用javax.servlet命名空间，和你当前的Camel 3.8、现有web.xml配置完全兼容
• 不需要修改任何项目代码、依赖、配置，重新部署即可正常运行

方案2：升级项目适配Tomcat 10

如果必须使用Tomcat 10，需要做如下调整：

• 升级Camel版本到3.18及以上，将原有camel-servlet依赖替换为camel-servlet-jakarta，该组件的CamelHttpTransportServlet已经适配jakarta.servletAPI
• 升级Spring Boot到3.x系列，对应Spring 6+版本，官方原生支持Jakarta EE命名空间
• 调整配置：
  • 要么将web.xml的命名空间替换为Jakarta EE对应版本，同时替换Spring ContextLoaderServlet为适配Jakarta的实现类
  • 要么直接删除web.xml，按照Spring Boot打WAR包的标准规范，继承SpringBootServletInitializer重写configure方法完成初始化，可完全省略web.xml配置
• 全局排查依赖，排除所有javax.servlet相关的旧包，引入jakarta.servlet-api依赖，scope设为provided

注意：选择方案2时，建议先通过mvn dependency:tree命令检查所有依赖的命名空间，避免出现javax和jakarta两类Servlet API共存的冲突问题。

内容的提问来源于stack exchange，提问作者El.Psy.Kongroo