如何配置Maven：启动Tomcat后执行测试，完成后停止服务

这问题我之前做集成测试时踩过坑，给你一套靠谱的配置方案，用Maven插件就能完美实现「启动Tomcat→执行测试→停止Tomcat」的闭环，不用手动干预服务器状态。

核心思路 #

我们要把Tomcat的启动、停止动作绑定到Maven构建生命周期的集成测试阶段：

• 启动Tomcat绑定到pre-integration-test阶段（测试前执行）
• 执行集成测试用maven-failsafe-plugin（专门用于依赖外部服务的集成测试，和单元测试的surefire区分开）
• 停止Tomcat绑定到post-integration-test阶段（测试后执行）

具体POM配置 #

直接把以下配置加到你的pom.xml的<build><plugins>节点里：

1. Tomcat7 Maven插件（负责启停服务器） #

<plugin>
    <groupId>org.apache.tomcat.maven</groupId>
    <artifactId>tomcat7-maven-plugin</artifactId>
    <version>2.2</version>
    <configuration>
        <!-- 配置Tomcat端口，避免和本地其他服务冲突 -->
        <port>8081</port>
        <!-- 部署的上下文路径，比如你的应用访问地址是http://localhost:8081/myapp -->
        <path>/myapp</path>
        <!-- 如果需要自定义JVM参数，比如内存设置 -->
        <jvmArguments>-Xmx512m -Xms256m</jvmArguments>
        <!-- 配置WAR包路径，默认会用项目生成的WAR -->
        <warFile>${project.build.directory}/${project.build.finalName}.war</warFile>
    </configuration>
    <executions>
        <!-- 启动Tomcat：绑定到pre-integration-test阶段 -->
        <execution>
            <id>start-tomcat</id>
            <phase>pre-integration-test</phase>
            <goals>
                <goal>run-war-only</goal>
            </goals>
        </execution>
        <!-- 停止Tomcat：绑定到post-integration-test阶段 -->
        <execution>
            <id>stop-tomcat</id>
            <phase>post-integration-test</phase>
            <goals>
                <goal>shutdown</goal>
            </goals>
        </execution>
    </executions>
</plugin>

注意：run-war-only目标会直接启动Tomcat并部署WAR，不会阻塞后续Maven流程；如果用run目标，会卡住直到手动停止，别选错了。

2. Failsafe插件（负责执行集成测试） #

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <version>3.0.0-M7</version>
    <executions>
        <execution>
            <goals>
                <goal>integration-test</goal>
                <goal>verify</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <!-- 可选：配置测试超时时间，避免测试卡住 -->
        <forkedProcessTimeoutInSeconds>300</forkedProcessTimeoutInSeconds>
    </configuration>
</plugin>

这里要注意测试类的命名规则：Failsafe默认识别**/IT*.java、**/*IT.java或**/*TestCase.java格式的文件作为集成测试类，比如UserApiIT.java，这样会和单元测试（Surefire默认**/Test*.java）区分开，不会混跑。

执行命令 #

配置完后，直接运行：

mvn verify

Maven会自动按以下顺序执行：

1. 编译、打包生成WAR包
2. pre-integration-test：启动Tomcat并部署WAR
3. integration-test：执行所有集成测试类
4. post-integration-test：停止Tomcat
5. 最后执行verify阶段验证测试结果

踩坑提醒 #

• 端口冲突：如果本地8081端口被占，直接改Tomcat插件里的<port>值就行
• WAR包路径错误：如果你的WAR不是默认生成路径，要手动指定<warFile>的路径
• 测试超时：如果测试需要更长时间，调整Failsafe的forkedProcessTimeoutInSeconds参数
• 依赖问题：确保测试代码里的接口地址和Tomcat配置的path、port一致，比如http://localhost:8081/myapp/api/user

备选方案：Cargo插件（支持更多服务器） #

如果你的项目需要部署到Tomcat以外的服务器（比如Jetty、WildFly），可以用cargo-maven2-plugin，配置逻辑类似，也是绑定到集成测试阶段，只是插件参数略有不同，核心思路和上面一致。

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