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
相关产品推荐
相关产品推荐

