JUnit4参数化测试迁移至JUnit5时出现类型不兼容错误，求正确迁移方案

嗨，这个问题我之前迁移项目时也踩过坑！核心原因是JUnit 5的参数化测试机制和JUnit 4完全不是一套东西，你不能直接把JUnit 4的Parameterized Runner换成@ExtendWith注解来用——那个org.junit.runners.Parameterized是JUnit 4专属的Runner类，根本不是JUnit 5要求的Extension类型，所以才会报类型不兼容的错误。

下面给你一步步讲正确的迁移方案：

第一步：确保引入正确的依赖 #

JUnit 5的参数化测试功能单独封装在junit-jupiter-params模块里，如果你用Maven，需要在pom.xml中添加这个依赖（版本和你的JUnit Jupiter核心依赖保持一致即可）：

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-params</artifactId>
    <version>5.9.2</version> <!-- 建议使用最新稳定版 -->
    <scope>test</scope>
</dependency>

如果是Gradle项目，就在build.gradle里添加：

testImplementation 'org.junit.jupiter:junit-jupiter-params:5.9.2'

第二步：重写参数化测试代码 #

把原来的JUnit 4代码完全替换为JUnit 5的写法，核心变化点如下：

1. 移除@RunWith/@ExtendWith这类旧注解
2. 用@ParameterizedTest替代原来的@Test注解
3. 用@MethodSource指定提供测试数据的方法（替代JUnit 4的@Parameterized.Parameters）
4. 测试方法可以直接接收参数（或者用构造方法注入，看个人习惯）

给你一个完整的迁移后示例：

import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.MethodSource;

import java.util.Arrays;
import java.util.Collection;

public class LocaleTest {

    // 测试方法：直接接收参数，和数据组中的值一一对应
    @ParameterizedTest(name = "{index}: Locale={0}, valid={1}")
    @MethodSource("provideLocaleTestData")
    void testLocaleValidation(String locale, boolean isValid) {
        // 这里编写你的测试逻辑，比如断言验证结果
        // 示例：假设你有一个LocaleValidator工具类
        // assertEquals(isValid, LocaleValidator.isValid(locale));
    }

    // 提供测试数据的方法：逻辑和原来一致，但不需要加旧的@Parameterized.Parameters注解
    public static Collection<Object[]> provideLocaleTestData() {
        return Arrays.asList(new Object[][]{
            {"os_PT", true},
            {"en_PH", true},
            // 这里继续添加你的其他测试用例
        });
    }
}

如果你习惯用类字段接收参数（和JUnit 4的写法更接近），也可以用构造方法注入的方式：

import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.MethodSource;

import java.util.Arrays;
import java.util.Collection;

public class LocaleTest {

    private final String locale;
    private final boolean isValid;

    // 通过构造方法注入参数
    public LocaleTest(String locale, boolean isValid) {
        this.locale = locale;
        this.isValid = isValid;
    }

    @ParameterizedTest(name = "{index}: Locale={0}, valid={1}")
    @MethodSource("provideLocaleTestData")
    void testLocaleValidation() {
        // 直接使用类字段执行测试
        // assertEquals(isValid, LocaleValidator.isValid(locale));
    }

    public static Collection<Object[]> provideLocaleTestData() {
        return Arrays.asList(new Object[][]{
            {"os_PT", true},
            {"en_PH", true},
            // 其他测试用例
        });
    }
}

额外小提示 #

JUnit 5的参数化测试还支持更灵活的数据来源，比如@CsvSource直接在注解里写数据、@ValueSource适配单参数场景等等，如果你有兴趣可以深入研究，但针对你原来的JUnit 4代码，用@MethodSource是最直接的迁移方式。

备注：内容来源于stack exchange，提问作者Peter Penzov