如何使用Maven对多模块JavaEE REST API项目进行集成测试？

我来帮你梳理下针对这种多模块JavaEE REST API项目用Maven做集成测试的具体步骤和最佳实践，咱们一步步来：

首先，建议你在项目根目录下新增一个专门的集成测试模块（比如mod-integration-test），而不是把集成测试代码塞进业务模块里。这么做的好处是：

• 把集成测试和单元测试彻底分离，避免构建逻辑混乱
• 可以灵活依赖所有业务模块（mod-pojo、mod-util、mod-webapi-war）
• 方便单独执行集成测试，不影响日常开发的单元测试流程

这个模块的结构很简单，和其他jar模块类似：

project
|-- ...（其他模块）
|-- mod-integration-test
|   |-- pom.xml
|   `-- src
|       |-- main（可选，一般不用）
|       `-- test
|           |-- java
|           |   `-- com
|           |       `-- mycompany
|           |           `-- myapp
|           |               `-- HomeServletIT.java  # 集成测试类，命名要符合Failsafe规则
|           `-- resources
|               `-- log4j.properties  # 集成测试专用的配置

集成测试要用到Maven的maven-failsafe-plugin（和单元测试用的surefire插件区分开），它默认识别命名为**/IT*.java或**/*IT.java的测试类，完美和单元测试划清界限。

你可以在父pom的<build><pluginManagement>里统一配置插件，或者直接在mod-integration-test的pom里配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-failsafe-plugin</artifactId>
            <version>3.2.5</version> <!-- 用最新稳定版 -->
            <executions>
                <execution>
                    <goals>
                        <goal>integration-test</goal>
                        <goal>verify</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

同时，在mod-integration-test的pom里添加对其他模块的依赖：

<dependencies>
    <!-- 依赖业务模块 -->
    <dependency>
        <groupId>com.mycompany</groupId>
        <artifactId>mod-pojo</artifactId>
        <version>${project.parent.version}</version>
    </dependency>
    <dependency>
        <groupId>com.mycompany</groupId>
        <artifactId>mod-util</artifactId>
        <version>${project.parent.version}</version>
    </dependency>
    <!-- 依赖web模块，用于测试API -->
    <dependency>
        <groupId>com.mycompany</groupId>
        <artifactId>mod-wepapi-war</artifactId>
        <version>${project.parent.version}</version>
        <type>war</type>
        <scope>test</scope>
    </dependency>
    <!-- 测试依赖：JUnit、REST客户端等 -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.9.2</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>io.rest-assured</groupId>
        <artifactId>rest-assured</artifactId>
        <version>5.3.0</version>
        <scope>test</scope>
    </dependency>
</dependencies>

以测试你的HomeServlet为例，写一个HomeServletIT.java，用RestAssured发送HTTP请求验证API响应：

package com.mycompany.myapp;

import io.restassured.RestAssured;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import static io.restassured.RestAssured.given;
import static org.hamcrest.Matchers.equalTo;

public class HomeServletIT {

    @BeforeAll
    public static void setUp() {
        // 配置测试的base URL，后续会结合容器插件自动启动的地址
        RestAssured.baseURI = "http://localhost:8080/myapp";
    }

    @Test
    public void testHomeServletResponse() {
        given()
            .when()
                .get("/home")
            .then()
                .statusCode(200)
                .body(equalTo("Welcome to My App!")); // 根据实际响应调整
    }
}

集成测试需要把mod-webapi-war部署到容器里才能测试，你可以用jetty-maven-plugin或者tomcat-maven-plugin，让Maven在集成测试阶段自动启动容器，测试完成后自动停止。

在mod-webapi-war的pom里添加容器插件配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.eclipse.jetty</groupId>
            <artifactId>jetty-maven-plugin</artifactId>
            <version>11.0.15</version>
            <executions>
                <execution>
                    <id>start-jetty</id>
                    <phase>pre-integration-test</phase>
                    <goals>
                        <goal>start</goal>
                    </goals>
                    <configuration>
                        <daemon>true</daemon> <!-- 后台启动，不阻塞构建 -->
                        <port>8080</port>
                        <war>${project.build.directory}/${project.build.finalName}.war</war>
                    </configuration>
                </execution>
                <execution>
                    <id>stop-jetty</id>
                    <phase>post-integration-test</phase>
                    <goals>
                        <goal>stop</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

确保父pom的<modules>列表里，mod-integration-test放在最后，这样Maven会按依赖顺序构建：

<modules>
    <module>mod-pojo</module>
    <module>mod-util</module>
    <module>mod-wepapi-war</module>
    <module>mod-integration-test</module>
</modules>

一切配置好后，在项目根目录执行以下命令即可触发完整的集成测试流程：

mvn verify

这个命令会：

1. 依次构建所有业务模块
2. 在pre-integration-test阶段启动Jetty/Tomcat并部署war包
3. 执行集成测试用例
4. 在post-integration-test阶段停止容器
5. 验证测试结果，失败则构建终止

如果你只想单独执行集成测试（跳过单元测试），可以用：

mvn verify -DskipTests

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