已添加servlet-api.jar仍出现The import javax.servlet cannot be resolved报错求助

问题根源 #

你将servlet-api.jar添加到全局JRE扩展库后仍报错，核心原因如下：

1. Eclipse Web项目默认遵循Java EE规范约束，禁止读取JRE库中包含的Servlet这类容器提供的API，避免开发阶段引入的API版本和部署时容器自带版本不一致引发类加载冲突
2. 项目级构建路径、目标运行时配置优先级高于全局JRE配置，全局添加的包会被项目配置覆盖

解决方法 #

方案1：绑定项目目标运行时（最推荐）

• 右键报错的Web项目，选择「Properties」
• 左侧菜单选中「Targeted Runtimes」
• 勾选已在Eclipse中配置的Tomcat、Jetty等Servlet容器，点击应用
• 等待项目自动构建完成后，报错即可消失
  该方案直接复用容器自带的servlet-api包，完全规避开发与部署环境的API冲突问题。

方案2：项目内引入servlet-api依赖

普通Web项目

• 右键项目，依次选择「Build Path」->「Configure Build Path」
• 切换到「Libraries」标签，点击「Add External JARs」
• 选择本地Servlet容器安装目录下lib文件夹中的servlet-api.jar，添加后应用即可

Maven项目

在pom.xml中添加如下依赖，scope设置为provided表示部署时由容器提供，无需打包：

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
</dependency>

如果使用Jakarta EE 9及以上版本，替换为对应jakarta.servlet依赖即可。

方案3：修改JRE库访问规则（仅临时测试使用，不推荐）

如果必须使用全局JRE中添加的servlet-api.jar，可手动放开访问限制：

• 打开项目构建路径的「Libraries」标签，展开「JRE System Library」
• 双击「Access rules」，点击「Add」
• 规则选择「Accessible」，规则模式填写javax/servlet/**，保存应用后生效
  该方案容易引发后续部署阶段的类冲突，不建议长期使用。

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