JUnit 4 搭配 maven-surefire-plugin 2.19 并行测试无法生效

我之前在维护老项目的时候碰到过几乎一模一样的问题——用Maven 3.5搭配Surefire 2.19+JUnit 4.12跑并行测试，要么没提速要么直接挂起，结合你用SpringRunner的场景，给你几个针对性的排查和解决方向：

1. 先确认Surefire并行配置的正确性（2.19版本有特定写法） #

Surefire 2.19的并行配置和后续版本有些差异，别用高版本的配置语法。推荐你在pom里明确以下关键配置，优先用**进程级并行（fork）**结合线程级并行，避免Spring上下文的冲突：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.19</version>
    <configuration>
        <!-- 按测试类并行，比按方法并行更适配SpringRunner的上下文缓存 -->
        <parallel>classes</parallel>
        <!-- 线程数建议设为CPU核心数的1-2倍，别贪多 -->
        <threadCount>4</threadCount>
        <!-- fork进程数，比如设为2，每个进程处理部分测试，隔离性更好 -->
        <forkCount>2</forkCount>
        <!-- 复用fork进程减少开销，若还是挂起可以改成false -->
        <reuseForks>true</reuseForks>
        <!-- 自动根据核心数调整线程数 -->
        <perCoreThreadCount>true</perCoreThreadCount>
    </configuration>
</plugin>

如果是在Jenkins命令行运行，别加会覆盖配置的参数（比如-DforkCount=1），确保pom里的配置生效。

2. 解决SpringRunner的上下文并发冲突 #

SpringRunner默认会缓存测试上下文，并行测试时如果多个线程/进程复用同一上下文，很容易出现资源竞争导致挂起或变慢。

• 如果你测试类之间的上下文依赖隔离，在每个测试类上加上@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_CLASS)，确保测试类执行完后销毁上下文，避免后续测试冲突。
• 如果用parallel=methods模式，建议关闭上下文缓存（或者用@DirtiesContext(methodMode = DirtiesContext.MethodMode.AFTER_EACH_METHOD)），但这样会增加上下文初始化的开销，所以更推荐先用parallel=classes。

3. 调整Jenkins节点的资源与并行参数 #

Jenkins多分支流水线的节点资源是关键：

• 别把forkCount或threadCount设得太高，比如节点只有4核，你设threadCount=8会导致频繁上下文切换，反而变慢甚至挂起。建议先从forkCount=1C（C代表核心数）、threadCount=2C开始测试。
• 确保Jenkins节点没有其他负载，并行测试对CPU和内存消耗很大，若节点同时跑其他任务，肯定会出问题。

4. 检查测试代码的线程安全性 #

很多时候并行失败不是配置的问题，是测试代码本身有问题：

• 检查是否有共享的静态变量、全局资源（比如单例服务、数据库连接），这些在并行时会有竞态条件，导致测试挂起或失败。
• 确保每个测试方法都是独立的，不要依赖其他测试的执行结果，也不要在测试中修改全局状态。

最后试个小验证 #

先在本地跑mvn test看并行是否生效（看控制台输出会有Parallelizing tests的日志），如果本地能正常并行，再去Jenkins上调整节点资源和命令，排除环境差异的问题。

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