You need to enable JavaScript to run this app. Spring Boot 2.1.5迁移至2.4.0后JUnit4测试不执行,如何不迁移Jupiter保留旧用例
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot 2.1.5迁移至2.4.0后JUnit4测试不执行,如何不迁移Jupiter保留旧用例

适配方案(无需修改现有JUnit4测试代码)

出现0个测试被执行的核心原因是:Spring Boot 2.4.0 开始,spring-boot-starter-test默认不再内置JUnit4兼容组件——原来随starter一起引入的junit-vintage-engine被从默认依赖中移除,测试执行平台完全切换为JUnit5(Jupiter)原生模式,无法识别传统JUnit4编写的用例注解,自然扫描不到任何测试。整个适配过程不需要改动任何现有测试代码,仅通过Maven依赖调整即可完成。

具体配置步骤

  • 保留项目中原有的JUnit4依赖配置,和Spring Boot 2.1.5版本下的写法完全一致,不需要调整版本:
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.4</version>
        <scope>test</scope>
    </dependency>
    
  • 补充JUnit5平台兼容JUnit4的核心引擎依赖,Spring Boot 2.4.0的父POM已经统一管理了该依赖的版本,不需要手动指定版本号:
    <!-- JUnit Vintage引擎:负责在JUnit5测试平台下识别、执行传统JUnit4/JUnit3用例 -->
    <dependency>
        <groupId>org.junit.vintage</groupId>
        <artifactId>junit-vintage-engine</artifactId>
        <scope>test</scope>
    </dependency>
    
  • 检查spring-boot-starter-test的依赖配置,确认没有手动排除上述vintage引擎、也没有硬编码指定仅加载Jupiter测试引擎:
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
    

常见排坑提示

  • 不需要修改现有测试用例的任何代码,只要保持和原版本一致的注解导入路径(比如org.junit.Test、配合Spring测试的SpringRunner注解),Vintage引擎会自动完成识别,和之前在2.1.5版本下的执行逻辑完全一致。
  • 如果配置完成后仍提示0个测试执行,顺着全链路依赖树检查一遍,确认有没有之前为了适配JUnit5写的排除规则,把junit-vintage-engine给意外剔除了。
  • 不需要额外调整Maven Surefire插件的配置,Spring Boot 2.4.0默认集成的Surefire版本已经支持多测试引擎并行加载,加完依赖后可以同时识别、运行JUnit4和JUnit5编写的用例,不会互相冲突。

配置完成后重新执行mvn clean test,即可正常加载并执行所有历史JUnit4测试用例。


内容的提问来源于stack exchange,提问作者Shades88

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 18:24:03