单元测试中如何跳过某些用例

为什么需要跳过单元测试用例

在日常开发中，我们写完代码后通常会配套写一些单元测试。但有时候并不是所有测试都需要每次都跑一遍。比如某个接口依赖外部支付系统，测试环境没法调通；或者某个功能还在开发中，相关测试写好了但暂时不能执行。这时候，跳过特定的测试用例就成了刚需。

直接删掉测试？不行，以后还得补。注释掉？容易忘，还可能误提交。更好的做法是让测试框架知道：这个用例现在先别跑，但我记得它存在。

常见测试框架中的跳过方式

以 Python 的 unittest 为例，跳过某个测试方法非常简单：

import unittest

class TestPayment(unittest.TestCase):

    @unittest.skip("支付网关尚未接入测试环境")
    def test_pay_order(self):
        self.assertTrue(pay(100))

    def test_create_order(self):
        self.assertIsNotNone(create_order("book"))

运行时，test_pay_order 会直接被标记为“跳过”，不会执行，也不会报错。输出结果里会显示一条提示，说明被跳过了，方便后续追踪。

如果你只想在满足某些条件时才跳过，可以用 skipIf 或 skipUnless。比如只在 Windows 系统跳过某个测试：

@unittest.skipIf(sys.platform == "win32", "不支持Windows平台")
def test_linux_only_feature(self):
    run_linux_command()

JUnit 中的类似机制

Java 开发者常用 JUnit，处理方式也很直观。使用 @Ignore 注解就能跳过：

@Test
@Ignore("数据库连接未配置")
public void testUserSave() {
    User user = new User("zhangsan");
    userDao.save(user);
    assertNotNull(user.getId());
}

对应的，JUnit 5 改成了 @Disabled，语义更清晰：

@Test
@Disabled("功能暂未完成")
void testNewFeature() {
    // 待实现
}

实际项目中的使用场景

我们团队之前做微服务拆分，有个订单服务要调用户服务查权限。本地跑单元测试时，用户服务没启动，testCheckPermission 每次都超时失败。后来加上了跳过注解，CI 流水线也不受影响了。

等联调环境准备好了，再把注解去掉，测试自然就会重新纳入执行范围。这种“临时绕行”既不影响进度，又不会遗忘待办事项。

跳过测试不是逃避问题，而是合理管理测试生命周期的一种方式。关键是要写清楚原因，别让同事看到一堆跳过的用例却不知道为啥。