XUnit TestCaseOrderer：实现测试失败时中断执行的问题

Xunit的测试排序器（ITestCaseOrderer）仅负责测试用例的排序，无法直接获取测试执行的结果状态，所以要实现“测试失败即中断后续执行”的需求，需要结合共享状态跟踪和自定义测试特性来完成，具体步骤如下：

1. 实现测试失败状态跟踪类 #

创建静态类来全局跟踪是否有测试失败：

public static class TestFailureTracker
{
    public static bool HasTestFailed { get; set; }
}

2. 自定义测试特性，添加状态检查逻辑 #

继承FactAttribute（如果使用Theory则继承TheoryAttribute），在测试执行前后加入状态检查：

public class OrderedFactAttribute : FactAttribute
{
    public override string Skip
    {
        get => TestFailureTracker.HasTestFailed ? "前置测试失败，终止后续执行" : base.Skip;
        set => base.Skip = value;
    }

    public override void Before(ITest test)
    {
        if (TestFailureTracker.HasTestFailed)
        {
            Skip = "前置测试失败，终止后续执行";
        }
        base.Before(test);
    }

    public override void After(ITest test)
    {
        if (test.TestCase.Result?.Status == TestStatus.Failed)
        {
            TestFailureTracker.HasTestFailed = true;
        }
        base.After(test);
    }
}

3. 保留原PriorityOrderer排序逻辑 #

你的排序器不需要修改yield break的逻辑，保持原有排序逻辑即可：

public class PriorityOrderer : ITestCaseOrderer
{
    public IEnumerable<TTestCase> OrderTestCases<TTestCase>(IEnumerable<TTestCase> testCases) where TTestCase : ITestCase
    {
        var sortedMethods = new SortedDictionary<int, List<TTestCase>>();

        foreach (TTestCase testCase in testCases)
        {
            int priority = 0;
            foreach (IAttributeInfo attr in testCase.TestMethod.Method.GetCustomAttributes((typeof(PriorityAttribute).AssemblyQualifiedName)))
                priority = attr.GetNamedArgument<int>("Priority");

            if (!sortedMethods.ContainsKey(priority))
                sortedMethods[priority] = new List<TTestCase>();

            sortedMethods[priority].Add(testCase);
        }

        foreach (TTestCase testCase in
            sortedMethods.Keys.SelectMany(
                priority => sortedMethods[priority].OrderBy(
                    testCase => testCase.TestMethod.Method.Name)))
        {
            yield return testCase;
        }
    }
}

4. 测试类与测试方法的使用 #

• 在测试类上标记排序器：

  [TestCaseOrderer("你的命名空间.PriorityOrderer", "你的程序集名称")]
  public class YourTestClass
  {
      // 测试方法用自定义特性替代Fact
      [OrderedFact(Priority = 1)]
      public void FirstTest()
      {
          // 测试逻辑
      }
  
      [OrderedFact(Priority = 2)]
      public void SecondTest()
      {
          // 测试逻辑
      }
  }
  

原理说明 #

自定义的OrderedFactAttribute会在每个测试执行前检查全局状态，如果已有测试失败，就将当前测试标记为跳过；在测试执行完成后，若当前测试失败，则更新全局失败状态。这样就能实现“一旦某个测试失败，后续所有测试不再执行”的效果。

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