如何避免JUnit @Category+SpringRunner集成测试上下文在单元测试阶段初始化？

我之前也碰到过一模一样的问题——明明用@Category标记了集成测试类，结果运行单元测试时，这些类的Spring上下文还是会被部分初始化，日志里全是相关的加载信息。核心原因是Maven Surefire插件（负责test阶段的单元测试）没有正确过滤掉标记为IntegrationTest的测试类，导致这些类被JVM加载，而类上的@SpringBootTest等注解会触发Spring上下文的初始化流程。

下面是具体的解决方案：

1. 确保Surefire和Failsafe插件的正确配置 #

Maven中，maven-surefire-plugin负责单元测试（test阶段），maven-failsafe-plugin负责集成测试（integration-test阶段），需要分别配置它们的测试过滤规则：

首先，定义你的IntegrationTest标记接口（确保包路径正确）：

package com.yourproject.test.categories;

public interface IntegrationTest {}

然后在pom.xml中配置两个插件：

<build>
    <plugins>
        <!-- 单元测试：排除所有标记为IntegrationTest的测试类 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.2.5</version> <!-- 建议使用最新稳定版 -->
            <configuration>
                <!-- 排除指定分类的测试 -->
                <excludedGroups>com.yourproject.test.categories.IntegrationTest</excludedGroups>
                <!-- 可选：直接按类名排除，更稳妥 -->
                <!-- <excludes>
                    <exclude>**/*IntegrationTest.java</exclude>
                </excludes> -->
            </configuration>
        </plugin>

        <!-- 集成测试：只运行标记为IntegrationTest的测试类 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-failsafe-plugin</artifactId>
            <version>3.2.5</version>
            <configuration>
                <includedGroups>com.yourproject.test.categories.IntegrationTest</includedGroups>
            </configuration>
            <executions>
                <execution>
                    <goals>
                        <goal>integration-test</goal>
                        <goal>verify</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

2. 验证测试类的标记是否正确 #

确保你的集成测试类上的@Category注解引用的是正确的接口，并且没有其他冲突的注解：

package com.yourproject.integrationtests;

import com.yourproject.test.categories.IntegrationTest;
import org.junit.runner.RunWith;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import org.junit.experimental.categories.Category;

@Category(IntegrationTest.class)
@RunWith(SpringRunner.class)
@SpringBootTest(classes = TestApp.class)
public class MyIntegrationTest {
    // 你的集成测试方法
}

3. 额外排查点 #

• 检查Surefire版本：旧版本的Surefire插件对@Category的支持可能有bug，建议升级到3.x以上的稳定版。
• 避免不必要的类引用：如果你的单元测试代码中不小心import了集成测试类，会导致JVM提前加载该类，触发上下文初始化，检查单元测试代码中是否有这类引用。
• 清理Maven缓存：有时候Maven的缓存会导致配置不生效，可以执行mvn clean后再重新运行测试。

这样配置后，运行mvn test时，Surefire会完全跳过所有标记为IntegrationTest的测试类，既不会执行它们的测试方法，也不会加载这些类，自然就不会触发Spring上下文的初始化了。而运行mvn integration-test时，Failsafe会只执行这些集成测试类，完美分离两类测试。

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