本文详细讲解如何修复 eclipse 或其他 ide 中因 jakarta servlet api 未正确引入而导致的 “superclass jakarta.servlet.http.httpservlet was not found on the java build path” 编译错误，涵盖项目清理、maven 依赖配置及作用域设置等关键步骤。
本文详细讲解如何修复 eclipse 或其他 ide 中因 jakarta servlet api 未正确引入而导致的 “superclass jakarta.servlet.http.httpservlet was not found on the java build path” 编译错误，涵盖项目清理、maven 依赖配置及作用域设置等关键步骤。
该错误表明当前 Java 构建路径（Build Path）中缺少 Jakarta EE Servlet API 的核心类——尤其是 jakarta.servlet.http.HttpServlet。这通常发生在从传统 Java EE（如 javax.servlet.*）迁移至 Jakarta EE 9+（包名由 javax 迁移为 jakarta）后，IDE 未自动识别或加载对应 API。
✅ 首要排查：执行项目清理与重建
即使已安装相关插件或服务器适配器（如 Tomcat 10+），Eclipse 等 IDE 仍可能缓存旧构建状态。请务必执行：
Project → Clean… → 选中当前项目 → Clean，随后等待自动构建完成。若未启用自动构建，请手动触发 Project → Build Project。
✅ Maven 项目：正确声明 Jakarta Servlet API 依赖
使用 Maven 管理依赖时，切勿再引用过时的 javax.servlet:javax.servlet-api（仅适用于 Tomcat 9 及以下）。对于 Jakarta EE 9+ 兼容环境（如 Tomcat 10/11、Jetty 11+、WildFly 26+），需在 pom.xml 中添加如下 provided 作用域依赖：
<dependency><groupid>jakarta.platform</groupid><artifactid>jakarta.jakartaee-api</artifactid><version>10.0.0</version><scope>provided</scope></dependency>
? 说明：
- version="10.0.0" 对应 Jakarta EE 10 规范，兼容 Servlet 6.0；若使用 Jakarta EE 9（Servlet 5.0），可改用
9.1.0 。provided 表示该 API 由运行容器（如 Tomcat）提供，不可打包进 WAR，否则将引发类冲突或 java.lang.LinkageError。
⚠️ 注意事项与常见误区
- ❌ 不要同时引入 javax.servlet-api 和 jakarta.servlet-api，二者包路径互斥，会导致编译失败或运行时异常；
- ❌ 避免手动下载 JAR 并 Add to Build Path —— 这会绕过 Maven 依赖管理，易引发版本不一致；
- ✅ 检查服务器运行时是否匹配：Tomcat 9 使用 javax.*，Tomcat 10+ 强制要求 jakarta.*；务必在 Eclipse 中右键项目 → Properties → Targeted Runtimes，选择对应 Jakarta 兼容服务器；
- ✅ 若使用 Spring Boot，优先采用 spring-boot-starter-web（其内部已自动适配 Jakarta Servlet，无需额外声明）。
完成上述配置后，刷新 Maven 项目（右键 → Maven → Reload），并再次 Clean & Build。绝大多数情况下，HttpServlet 找不到的问题将立即解决。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
