Wildfly 23部署Jakarta Servlet报错未实现javax.servlet.Servlet咨询

根因说明 #

报错与注解不生效的核心原因是应用服务器版本与依赖的Servlet规范命名空间不匹配：

• WildFly 23 是Java EE 8适配版本，全栈使用javax.*命名空间。内置Undertow容器校验Servlet时仅检查是否实现javax.servlet.Servlet接口，Servlet注解扫描仅识别javax.servlet.annotation.WebServlet。
• 当前使用的Servlet API 5.0.0属于Jakarta EE 9规范产物，全栈使用jakarta.*命名空间。自定义Servlet继承的HttpServlet最终实现的是jakarta.servlet.Servlet，和WildFly 23运行环境要求的接口不兼容；@WebServlet注解属于jakarta包下，也无法被WildFly 23的扫描逻辑识别。

解决方案 #

可根据实际部署场景二选一：

方案1：升级应用服务器（推荐） #

将WildFly升级到24及以上稳定版本。WildFly 24开始原生支持Jakarta EE 9规范，内置容器的校验、扫描逻辑均已适配jakarta.*命名空间，现有代码和依赖无需修改即可正常部署运行。

方案2：回退依赖到javax命名空间版本（适配WildFly 23） #

如果无法升级应用服务器，需将所有相关依赖和代码全部切换回Java EE 8规范：

• 将Servlet API依赖版本降至4.0.1及以下，对应javax.servlet命名空间
• 全局替换代码中所有import jakarta.servlet为import javax.servlet
• 将JAX-WS实现版本回退到2.x的javax命名空间版本，不得使用3.x及以上的jakarta适配版

内容的提问来源于stack exchange，提问作者Faliorn