多模块Maven项目：默认跳过集成测试，按需执行的实现方案

这问题我太熟了，之前维护多模块Maven项目时刚好做过一模一样的配置，给你一套完整可落地的方案：

核心思路就是：默认让Maven只执行业务模块（module1、module2）的单元测试，把集成测试单独隔离到integration-test模块中，通过Profile或命令行参数按需触发，同时确保集成测试失败时直接终止构建流程。

1. 父POM核心配置（控制默认行为） #

先在父pom里统一配置单元测试和集成测试插件，默认跳过集成测试，保证mvn clean install只跑单元测试：

<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.yourcompany</groupId>
    <artifactId>parent-project</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <packaging>pom</packaging>
    <modules>
        <module>module1</module>
        <module>module2</module>
        <module>integration-test</module>
    </modules>

    <build>
        <pluginManagement>
            <plugins>
                <!-- 单元测试插件：默认执行所有业务模块的单元测试 -->
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <version>3.2.5</version>
                    <executions>
                        <execution>
                            <goals>
                                <goal>test</goal>
                            </goals>
                        </execution>
                    </executions>
                </plugin>

                <!-- 集成测试插件：默认跳过，通过Profile/命令行触发 -->
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-failsafe-plugin</artifactId>
                    <version>3.2.5</version>
                    <configuration>
                        <skipITs>true</skipITs> <!-- 默认跳过集成测试 -->
                        <failFast>true</failFast> <!-- 集成测试失败立刻终止构建 -->
                    </configuration>
                    <executions>
                        <execution>
                            <goals>
                                <goal>integration-test</goal>
                                <goal>verify</goal> <!-- 验证测试结果，失败则终止 -->
                            </goals>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>

    <!-- 定义触发集成测试的Profile -->
    <profiles>
        <profile>
            <id>run-integration-tests</id>
            <build>
                <plugins>
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-failsafe-plugin</artifactId>
                        <configuration>
                            <skipITs>false</skipITs> <!-- 激活Profile时关闭跳过 -->
                        </configuration>
                    </plugin>
                </plugins>
            </build>
        </profile>
    </profiles>
</project>

2. integration-test模块的POM配置 #

这个模块只负责集成测试，所以需要依赖业务模块，同时继承父pom的插件配置：

<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>com.yourcompany</groupId>
        <artifactId>parent-project</artifactId>
        <version>1.0.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>integration-test</artifactId>

    <dependencies>
        <!-- 依赖业务模块，确保集成测试能调用核心功能 -->
        <dependency>
            <groupId>com.yourcompany</groupId>
            <artifactId>module1</artifactId>
            <version>${project.version}</version>
        </dependency>
        <dependency>
            <groupId>com.yourcompany</groupId>
            <artifactId>module2</artifactId>
            <version>${project.version}</version>
        </dependency>
        <!-- 这里可以添加集成测试需要的额外依赖，比如测试框架、数据库驱动等 -->
    </dependencies>

    <build>
        <plugins>
            <!-- 继承父POM的failsafe配置，无需重复编写 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-failsafe-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

3. 集成测试类的命名规范 #

failsafe插件默认识别以下命名的测试类，一定要遵守，否则测试不会被执行：

• *IT.java（比如UserServiceIntegrationTest.java可以改成UserServiceIT.java）
• IT*.java（比如ITOrderProcessingFlow.java）
• *ITCase.java（比如PaymentVerificationITCase.java）

4. 使用方式 #

默认行为（只跑单元测试） #

直接执行命令，这时候只会构建所有模块并运行module1、module2的单元测试，集成测试会被跳过：

mvn clean install

按需执行集成测试 #

有两种灵活的触发方式：

1. 使用预定义的Profile（推荐团队统一使用，避免参数混乱）：

mvn clean install -Prun-integration-tests

2. 临时用命令行参数覆盖配置（适合临时测试场景）：

mvn clean install -DskipITs=false

两种方式都会先执行所有单元测试，再运行integration-test模块的集成测试，一旦集成测试失败，构建会立刻终止。

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