如何在类库中创建JUnit 5测试模板供他人传入测试数据使用？

针对你的需求，推荐用注解驱动+通用测试模板的实现方式，完全避免继承覆写的繁琐，使用者只需要编写测试数据类，无需接触测试逻辑代码。核心思路是把测试逻辑封装在通用模板里，通过注解识别用户提供的数据类，自动加载数据并执行测试。

具体实现步骤 #

1. 定义测试数据契约 #

先统一用户需要提供的数据格式，用一个DTO类封装新旧数据、迁移类信息：

public class MigrationTestData<T, U> {
    // 旧格式原始数据
    private T oldFormatData;
    // 迁移后预期的新格式数据
    private U expectedNewFormatData;
    // 负责本次迁移的实现类
    private Class<? extends DataMigrator<T, U>> migratorClass;

    // 全参构造器、getter方法
    public MigrationTestData(T oldFormatData, U expectedNewFormatData, Class<? extends DataMigrator<T, U>> migratorClass) {
        this.oldFormatData = oldFormatData;
        this.expectedNewFormatData = expectedNewFormatData;
        this.migratorClass = migratorClass;
    }

    // getter省略...
}

// 迁移类的通用接口（提前定义好，用户实现具体迁移逻辑）
public interface DataMigrator<T, U> {
    U migrate(T oldData);
}

2. 定义数据提供者注解 #

用一个注解标记用户的测试数据类，方便通用模板自动扫描识别：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface MigrationTestDataProvider {
}

3. 用户只需编写测试数据类 #

使用者不需要写任何测试代码，只需要创建一个带注解的数据类，返回测试数据集：

@MigrationTestDataProvider
public class UserMigrationTestData {
    // 固定方法名：getTestData，返回测试数据列表
    public static List<MigrationTestData<UserV1, UserV2>> getTestData() {
        return List.of(
            // 测试用例1：普通用户迁移
            new MigrationTestData<>(
                new UserV1("1", "Alice"),
                new UserV2("1", "Alice", ""),
                UserV1ToV2Migrator.class
            ),
            // 测试用例2：带昵称的用户迁移
            new MigrationTestData<>(
                new UserV1("2", "Bob", "Bobby"),
                new UserV2("2", "Bob", "Bobby"),
                UserV1ToV2Migrator.class
            )
        );
    }
}

4. 编写通用测试模板类 #

把所有测试逻辑封装在这里，自动扫描所有带注解的数据类，加载数据并执行测试：

import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.MethodSource;
import static org.junit.jupiter.api.Assertions.assertEquals;

public class GenericMigrationTest {

    @ParameterizedTest
    @MethodSource("loadAllTestData")
    public <T, U> void testMigration(MigrationTestData<T, U> testData) throws Exception {
        // 1. 实例化迁移类
        DataMigrator<T, U> migrator = testData.getMigratorClass().getDeclaredConstructor().newInstance();
        // 2. 执行迁移
        U actualResult = migrator.migrate(testData.getOldFormatData());
        // 3. 验证结果
        assertEquals(testData.getExpectedNewFormatData(), actualResult);
        
        // 可扩展更多通用测试逻辑：比如数据入库验证、约束检查、性能校验等
    }

    // 自动扫描所有测试数据提供者，加载数据
    private static Stream<MigrationTestData<?, ?>> loadAllTestData() {
        // 用Reflections库扫描指定包下的注解类（需引入reflections依赖）
        Reflections reflections = new Reflections("com.your.project.test.data");
        Set<Class<?>> dataProviderClasses = reflections.getTypesAnnotatedWith(MigrationTestDataProvider.class);

        return dataProviderClasses.stream()
            .map(clazz -> {
                try {
                    // 调用固定方法获取测试数据
                    Method dataMethod = clazz.getMethod("getTestData");
                    return (List<MigrationTestData<?, ?>>) dataMethod.invoke(null);
                } catch (Exception e) {
                    throw new RuntimeException("加载测试数据失败：" + clazz.getName(), e);
                }
            })
            .flatMap(List::stream);
    }
}

方案优势 #

• 零测试代码编写：使用者只需要维护测试数据，完全不用接触测试逻辑
• 解耦性强：用户数据类和测试模板无继承关系，避免类层次混乱
• 扩展性好：新增测试步骤（比如数据库写入验证）只需要修改通用模板，所有用户的测试都会自动生效
• 多场景支持：可以创建多个数据提供者类，分别负责不同业务模块的迁移测试

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