如何在JUnit中按测试规模分类？基于谷歌测试规模标准

嘿，这个问题问得很实际！在JUnit里按照small/medium/large这三类测试规模划分用例，核心是利用测试分类机制，结合谷歌那套测试规模的定义来落地——先给你理清楚三类测试的边界，再一步步说具体实现：

先明确下这三类测试的核心边界（参考谷歌的测试规模定义）：

• Small测试：完全在内存中运行，不依赖任何外部资源（数据库、网络、文件系统），执行速度极快（毫秒级），基本都是单元测试。
• Medium测试：会依赖轻量可控的外部资源，比如嵌入式数据库、本地缓存，执行时间在几秒级，属于集成测试范畴。
• Large测试：依赖完整的外部服务（真实数据库、第三方API等），执行时间较长（几十秒甚至更久），一般是端到端或系统测试。

JUnit 5 实现方案（主流推荐） #

JUnit 5原生提供的@Tag注解就是为测试分类设计的，完美适配这个场景：

1. 给测试打规模标签 #

直接用@Tag给测试类或方法标记对应的规模：

import org.junit.jupiter.api.Tag;
import org.junit.jupiter.api.Test;

// 标记为small测试
@Tag("small")
public class UserServiceUnitTest {
    @Test
    void shouldCreateValidUser() {
        // 纯内存单元测试逻辑，无外部依赖
    }
}

// 标记为medium测试
@Tag("medium")
public class UserRepositoryIntegrationTest {
    @Test
    void shouldSaveUserToEmbeddedDB() {
        // 依赖嵌入式H2数据库的集成测试
    }
}

// 标记为large测试
@Tag("large")
public class UserApiE2ETest {
    @Test
    void shouldReturnUserWhenCallingExternalApi() {
        // 依赖真实外部API的端到端测试
    }
}

2. 执行时过滤指定规模的测试 #

• IDE内执行：在IntelliJ、Eclipse等IDE的JUnit运行配置里，找到“Tags”选项，指定只运行small标签的测试，或者排除large标签的测试，非常灵活。
• 构建工具执行（Maven/Gradle）：
  • Maven（借助surefire插件）：在pom.xml中配置过滤规则：

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>3.1.2</version>
                <configuration>
                    <!-- 只运行small规模的测试 -->
                    <groups>small</groups>
                    <!-- 或者排除large规模的测试 -->
                    <!-- <excludedGroups>large</excludedGroups> -->
                </configuration>
            </plugin>
        </plugins>
    </build>
    

  • Gradle：在build.gradle中配置：

    test {
        // 运行small和medium规模的测试
        includeTags 'small', 'medium'
        // 或者排除large规模的测试
        // excludeTags 'large'
    }
    

JUnit 4 实现方案（兼容旧项目） #

JUnit 4没有原生的标签功能，但可以通过自定义分类注解+JUnit分类器来实现：

1. 定义规模分类接口 #

先创建三个空接口，作为分类标记：

// 定义small测试的分类标记
public interface SmallTest {}
// 定义medium测试的分类标记
public interface MediumTest {}
// 定义large测试的分类标记
public interface LargeTest {}

然后用@Category注解给测试类/方法打标记：

import org.junit.Test;
import org.junit.experimental.categories.Category;

@Category(SmallTest.class)
public class UserServiceUnitTest {
    @Test
    void shouldCreateValidUser() { /* ... */ }
}

@Category(MediumTest.class)
public class UserRepositoryIntegrationTest {
    @Test
    void shouldSaveUserToEmbeddedDB() { /* ... */ }
}

2. 配置执行分类测试 #

• IDE内执行：在JUnit 4的运行配置中，选择“Categories”选项，指定要运行的分类（比如SmallTest）即可。
• 构建工具执行：
  • Maven（surefire插件）：

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>2.22.2</version>
        <configuration>
            <groups>com.yourpackage.SmallTest</groups>
        </configuration>
    </plugin>
    

  • Gradle：

    test {
        useJUnit {
            includeCategories 'com.yourpackage.SmallTest', 'com.yourpackage.MediumTest'
        }
    }
    

一些最佳实践 #

• 优先给整个测试类打标签，除非个别方法确实属于不同规模，这样分类逻辑更清晰，维护成本更低。
• 结合CI/CD流程优化：比如代码提交时只跑small测试保证快速反馈，每日定时构建跑small+medium测试，每周全量执行large测试，兼顾效率和覆盖率。
• 定期检查测试规模：避免测试“膨胀”——比如原本的small测试后来引入了外部依赖，要及时调整标签，不然会拖慢整个快速反馈环节。

内容的提问来源于stack exchange，提问作者Patrik Mihalčin