如何不大幅修改类结构将JUnit4参数化测试迁移至JUnit5

不需要大规模修改测试类结构，你之前尝试运行失败基本都是依赖缺失或配置错误导致的，按以下步骤调整即可。

前置依赖确认 #

首先确保项目中引入了JUnit5参数化测试对应的组件junit-jupiter-params，仅引入核心api包无法识别参数化测试相关注解，这是最常见的运行失败原因。

具体改动点 #

所有改动加起来不超过5行，原有数据源方法data()完全不需要修改：

• 删除类上的@RunWith(Parameterized.class)注解，JUnit5的扩展模型不需要指定Runner。
• 将测试方法上的JUnit4版本@Test注解替换为@ParameterizedTest + @MethodSource("data")组合注解，@MethodSource的value直接填你原有数据源方法名即可。
• 给测试方法增加和参数顺序匹配的形参，直接在方法内使用即可；原有类的私有字段、构造函数可以保留也可以删除，不会影响运行（仅会提示未被使用）。
• 把断言的静态导入从JUnit4的org.junit.Assert.assertEquals换成JUnit5的org.junit.jupiter.api.Assertions.assertEquals即可。

注意：你原有data()方法返回Collection<Object[]>的写法是JUnit5原生支持的，不需要强制改写为Stream<Arguments>格式，资料里提到的Arguments.of()写法只是可选格式之一，不是强制要求。

迁移后可直接运行的完整代码 #

public class FibonacciTest {
 
  // 原有数据源方法完全保留，不需要做任何格式修改
  public static Collection<Object[]> data() {
    return Arrays.asList(new Object[][] {
      {0,0},{1,1},{2,1},{3,2} });
  }
 
  private int input, expected;
 
  public FibonacciTest(int input, int expected) {
    this.input = input; this.expected = expected;
  }
 
  @ParameterizedTest
  @MethodSource("data")
  public void test(int input, int expected) {
    assertEquals(expected, Fibonacci.compute(input));
  }
}

常见运行失败的排查点 #

• 导包错误：确认@ParameterizedTest、@MethodSource、断言都来自org.junit.jupiter.api相关包，不要混导JUnit4的旧包。
• 数据源方法名不匹配：@MethodSource指定的方法名必须和静态数据源方法名一致，否则会抛出找不到数据源的错误。
• 测试引擎配置问题：如果是用Maven Surefire插件跑测试，确保插件版本在2.22.2以上，否则无法识别JUnit5用例。

如果非要保留原有构造函数注入字段、测试方法不接参数的写法，需要引入类参数化扩展，反而会增加额外配置和改动量，上述方法是改动成本最低的实现。

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