Eclipse构建GWT模块时JAX-RS 2.1安装失败报错求助

错误可能来源 #

• Eclipse的M2E插件会根据Maven依赖自动触发JAX-RS工具的校验，哪怕模块未手动添加JAX-RS/Dynamic Web Module facet。如果依赖中引入了JAX-RS 2.1版本的包，工具会自动检查Java版本兼容性。
• 模块的.classpath文件被M2E自动注入了JAX-RS类路径容器，触发版本校验。
• 模块代码或资源中存在JAX-RS相关注解（如@Path）或配置文件（如jaxrs-config.xml），被Eclipse的JAX-RS扫描工具识别。
• 工作空间全局JAX-RS配置默认启用了自动检测，对所有模块生效。

排查与解决步骤 #

1. 检查并清理Maven依赖 #

打开模块的pom.xml，排查是否存在JAX-RS 2.1版本的依赖（包括传递依赖）：

• 使用Maven Helper插件查看依赖树，搜索javax.ws.rs-api或jakarta.ws.rs-api，若版本为2.1：
  • 如果是直接依赖，降级到兼容Java 1.7的JAX-RS版本（如2.0）
  • 如果是传递依赖，在对应依赖中添加排除规则：

    <exclusion>
        <groupId>javax.ws.rs</groupId>
        <artifactId>javax.ws.rs-api</artifactId>
    </exclusion>
    

• 执行mvn clean install，然后右键项目→Maven→Update Project同步配置。

2. 修正Eclipse项目配置 #

• 检查.classpath文件：打开模块根目录下的.classpath，删除所有包含jaxrs的类路径条目，例如：

  <classpathentry kind="con" path="org.eclipse.jst.jaxrs.core.jaxrsclasspathcontainer"/>
  

  保存后刷新项目。
• 关闭Java EE自动集成：右键项目→属性→Maven→Java EE Integration，取消勾选「Enable Java EE Configuration」，点击应用后更新Maven项目。
• 检查项目Facet运行时：右键项目→属性→项目Facets→运行时，若存在JAX-RS相关运行时环境，选中后点击「移除」，应用配置。

3. 检查代码与资源文件 #

• 全局搜索模块内的Java类，确认是否误引入了JAX-RS注解（如@Path、@GET），若有则删除这些注解。
• 检查src/main/resources、src/main/webapp（若存在）目录下是否有jaxrs-config.xml、web.xml（含JAX-RS配置）等文件，若无需保留则删除。

4. 禁用不必要的Eclipse JAX-RS工具 #

如果项目完全不需要JAX-RS支持：

• 打开窗口→偏好设置→JAX-RS，取消勾选「Automatically enable JAX-RS capabilities for JAX-RS annotated classes」等自动检测选项。
• 若长期不用，可通过帮助→安装新软件→已安装的软件，找到「JAX-RS Tools」相关插件并卸载。

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