Eclipse中Maven更新项目失败：HelloREST配置异常求助

问题 #

用m2e工具基于Jersey做REST开发，适配Tomcat 10.1和Java 17后项目能正常部署运行，但修改pom.xml执行「Maven / Update Project ...」时，弹出配置更新失败报错：

Could not update project HelloREST configuration
Cannot invoke "org.eclipse.wst.common.componentcore.internal.WorkbenchComponent.findResourcesByRuntimePath(org.eclipse.core.runtime.IPath)"
because "aComponent" is null

同时Eclipse错误日志显示：

HelloREST/.settings/org.eclipse.wst.common.component is missing or invalid. Skipping module dependency configuration. Deployment issues may arise.

还附带空指针异常堆栈信息。试过简化项目、删除.metadata并重启Eclipse，报错还是没消失，目前项目没出其他问题，但怕后续出状况。

项目pom.xml内容如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>net.codejava</groupId>
    <artifactId>HelloREST</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>
    <name>HelloREST</name>
    <build>
        <plugins>
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <release>17</release>
                </configuration>
            </plugin>
            <plugin>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.2.3</version>
                <configuration>
                    <warName>HelloREST</warName>
                    <outputDirectory>/opt/tomcat/webapps/</outputDirectory>
                </configuration>
            </plugin>
        </plugins>
    </build>
    <dependencies>
        <dependency>
            <groupId>org.glassfish.jersey.containers</groupId>
            <artifactId>jersey-container-servlet</artifactId>
            <version>3.1.1</version>
        </dependency>
        <dependency>
            <groupId>org.glassfish.jersey.inject</groupId>
            <artifactId>jersey-hk2</artifactId>
            <version>3.1.1</version>
        </dependency>
        <dependency>
            <groupId>jakarta.ws.rs</groupId>
            <artifactId>jakarta.ws.rs-api</artifactId>
            <version>3.1.0</version>
        </dependency>
        <dependency>
            <groupId>jakarta.xml.bind</groupId>
            <artifactId>jakarta.xml.bind-api</artifactId>
            <version>4.0.0</version>
        </dependency>
        <dependency>
            <groupId>org.glassfish.jaxb</groupId>
            <artifactId>jaxb-runtime</artifactId>
            <version>4.0.1</version>
            <scope>runtime</scope>
        </dependency>
    </dependencies>
</project>

原因分析 #

这个问题核心是Eclipse的Web项目配置文件缺失或损坏：

• org.eclipse.wst.common.component是Eclipse WTP（Web工具平台）管理Web项目结构、资源映射和部署配置的关键文件，m2e更新项目时要靠它读取Web组件信息。
• 你的项目虽然是war打包类型，但可能创建时没正确生成WTP相关配置，或者后续操作中该文件被误删/损坏，导致m2e更新时找不到Web组件实例（也就是报错里的aComponent为null）。
• 项目能正常部署是因为Maven本身可以通过pom.xml生成war包并部署到Tomcat，但Eclipse内部的WTP配置缺失会影响IDE层面的项目同步和后续部署管理。

解决步骤 #

方法1：手动生成WTP配置文件 #

1. 在项目的.settings目录下新建org.eclipse.wst.common.component文件，粘贴以下内容（注意替换成你的项目名称）：

<?xml version="1.0" encoding="UTF-8"?>
<project-modules id="moduleCoreId" project-version="1.5.0">
    <wb-module deploy-name="HelloREST">
        <wb-resource deploy-path="/" source-path="/src/main/webapp"/>
        <wb-resource deploy-path="/WEB-INF/classes" source-path="/src/main/java"/>
        <wb-resource deploy-path="/WEB-INF/classes" source-path="/src/main/resources"/>
        <property name="context-root" value="HelloREST"/>
        <property name="java-output-path" value="/HelloREST/target/classes"/>
    </wb-module>
</project-modules>

2. 保存文件后右键项目→Refresh，再执行「Maven / Update Project ...」。

方法2：通过Eclipse重新配置Web项目属性 #

1. 右键项目→Properties→Project Facets。
2. 勾选Dynamic Web Module（Tomcat 10.1对应版本5.0），同时确保Java版本选17。
3. 点击Apply and Close，Eclipse会自动生成缺失的WTP配置文件。
4. 再执行一次「Maven / Update Project ...」。

方法3：重新导入项目 #

1. 从Eclipse中删除当前项目（别删本地文件）。
2. 执行File → Import → Existing Maven Projects，重新导入项目。
3. 导入时让Eclipse自动配置WTP相关属性，完成后再尝试更新项目。

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