Spring Boot中@Disabled注解禁用测试类未生效问题及相关疑问

核心疑问：类级别@Disabled是否会阻止生命周期方法执行？ #

直接给你明确结论：
当你在类级别使用JUnit Jupiter的@Disabled（包路径org.junit.jupiter.api.Disabled）注解时，整个测试类的所有内容都会被完全跳过——包括：

• 所有标注@Test的测试方法
• 所有生命周期方法：@BeforeAll、@AfterAll、@BeforeEach、@AfterEach

这些方法不会有任何执行动作，完全不会触发相关代码逻辑。如果你的生命周期方法仍然在执行，那一定是注解使用错误或者测试环境存在冲突。

你的测试未完全跳过的原因分析 #

从你提供的信息来看，给45个测试类都加了@Disabled，但执行mvn clean install后只有27个测试被跳过，还有113个被执行，这大概率是以下几个原因之一：

1. 注解混用（JUnit 4 vs JUnit Jupiter）

注意看你提供的示例代码：

// 用的是JUnit 4的@Ignore
import org.junit.Ignore;
// 但测试方法用的是JUnit Jupiter的@Test
import org.junit.jupiter.api.Test;

JUnit 4的@Ignore和JUnit Jupiter的@Disabled是两套独立的注解体系，如果测试类混合使用这两套注解，JUnit Jupiter的测试引擎可能无法正确识别JUnit 4的@Ignore，导致部分测试类没有被跳过。

正确做法：如果你的项目基于JUnit 5（Spring Boot 2.2+默认使用JUnit Jupiter），统一使用org.junit.jupiter.api.Disabled注解，替换掉所有JUnit 4的@Ignore。

2. 依赖冲突或测试引擎配置问题

检查你的pom.xml（或build.gradle）中的测试依赖：

• 确保spring-boot-starter-test是核心测试依赖，它默认包含JUnit Jupiter的正确配置
• 如果手动添加了JUnit 4的依赖（比如junit:junit），会导致测试引擎混乱，部分测试类可能被JUnit 4的引擎执行，而JUnit 4的引擎不识别JUnit Jupiter的@Disabled注解

3. 测试套件或配置强制执行测试

检查项目中是否存在测试套件类（比如标注@Suite的类），如果这些套件显式包含了你的测试类，即使类上加了@Disabled，也可能被套件强制执行。

另外，检查maven-surefire-plugin的配置，是否有参数强制运行所有测试，覆盖了@Disabled的设置。

验证与修复步骤 #

• 统一注解：把所有测试类的@Ignore（JUnit 4）替换为@Disabled（JUnit Jupiter），确保注解导入的是org.junit.jupiter.api.Disabled
• 清理依赖：移除pom.xml中多余的JUnit 4依赖，只保留spring-boot-starter-test
• 检查测试套件：确认没有测试套件强制包含被禁用的测试类
• 重新执行测试：运行mvn clean test，观察测试结果是否符合预期（所有测试都被跳过）

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