Java 单元测试怎么使用 @Disabled 跳过失效用例-java教程-PHP中文网

@disabled 是 junit 5 中临时跳过测试的注解，适用于逻辑有 bug、依赖外部服务不可用、ci 频繁失败或功能废弃等场景，加在方法或类上并推荐注明原因，替代已弃用的 junit 4 @ignore。

java 单元测试怎么使用 @disabled 跳过失效用例

在 Java 单元测试中（特别是 JUnit 5），@Disabled 是用来临时跳过某个测试方法或整个测试类的最直接方式，常用于失效、未完成、环境依赖或暂时不稳定的用例。

什么时候该用 @Disabled？

适用于以下情况：

测试逻辑有 bug，暂时无法修复，但又不想删掉代码
测试依赖外部服务（如数据库、HTTP 接口），当前环境不可用
测试在 CI 环境中频繁失败，需临时屏蔽以保障主流程通过
功能已废弃，但测试尚未清理

怎么加 @Disabled？

直接加在测试方法或测试类上即可，无需参数（也可加说明）：

js2java

JavaScript 到 Java 全栈翻译助手，专为前端开发者学习 Java 或快速实现后端业务逻辑而设计。当用户提到以下场景时必须使用此技能： - "帮我把这段 JS 代码转成 Java" - "用 Java 怎么写这个逻辑" - "我习惯用 JS 写，想翻译成 Java" - "教我 Java，我要写后端接...

下载

@Test
@Disabled // 无理由跳过（不推荐，建议写原因）
void testSomething() { ... }

@Test
@Disabled("暂不支持 IPv6 地址解析") // 推荐：说明跳过原因
void testWithIPv6() { ... }

@Disabled("整个类暂未适配新协议") // 作用于整个类
class NetworkIntegrationTests { ... }

注意和 @Ignore 的区别

JUnit 4 的 @Ignore 在 JUnit 5 中已被弃用，必须改用 @Disabled。如果项目还在混合使用 JUnit 4 和 5，要确认测试运行器是 JUnitPlatform（Maven Surefire 插件需配置 junit-jupiter 引擎），否则 @Disabled 不生效。