如何让XUnit Theory在首次失败时停止执行？

xUnit本身没有内置支持Theory用例失败后终止后续参数测试的功能，但可以通过以下几种方式实现需求：

方式一：静态标记变量+串行执行 #

在测试类中用静态变量标记是否已出现失败，测试方法开头检查该变量，同时强制测试串行执行避免并行冲突：

// 定义串行集合，强制测试类内方法串行执行
[CollectionDefinition("SerialTests")]
public class SerialTestCollection : ICollectionFixture<EmptyFixture> { }

public class EmptyFixture { }

[Collection("SerialTests")]
public class MapShortcutTests
{
    private static bool _testFailed = false;

    public static IEnumerable<object[]> TestParams()
    {
        yield return new object[] { MapMode.Default };
        yield return new object[] { MapMode.Expanded };
        yield return new object[] { MapMode.Minimized };
    }

    [Theory]
    [MemberData(nameof(TestParams))]
    public void FijewoShortcutTest(MapMode mapMode)
    {
        // 若已有失败，直接标记当前用例失败并终止
        if (_testFailed)
        {
            Assert.Fail("前置测试用例已失败，终止当前用例");
        }

        try
        {
            // 你的测试逻辑代码
            // ...
        }
        catch
        {
            _testFailed = true;
            throw; // 抛出异常保留失败记录
        }
    }
}

这种方式简单直接，缺点是静态变量会在测试类生命周期内保持状态，适合单一Theory测试的场景。

方式二：自定义MemberData特性 #

自定义继承自MemberDataAttribute的特性，内部跟踪失败状态，一旦检测到失败就停止提供后续参数：

public class StopOnFailureMemberDataAttribute : MemberDataAttribute
{
    private static bool _hasTestFailed = false;

    public StopOnFailureMemberDataAttribute(string memberName) : base(memberName) { }

    public override IEnumerable<object[]> GetData(MethodInfo testMethod)
    {
        if (_hasTestFailed) yield break;

        foreach (var paramSet in base.GetData(testMethod))
        {
            yield return paramSet;
            if (_hasTestFailed) yield break;
        }
    }

    // 提供重置方法，避免影响其他测试类
    public static void ResetFailureFlag()
    {
        _hasTestFailed = false;
    }
}

在测试类中使用该特性，并在失败时标记状态：

public class MapShortcutTests
{
    public static IEnumerable<object[]> TestParams()
    {
        yield return new object[] { MapMode.Default };
        yield return new object[] { MapMode.Expanded };
        yield return new object[] { MapMode.Minimized };
    }

    [Theory]
    [StopOnFailureMemberData(nameof(TestParams))]
    public void FijewoShortcutTest(MapMode mapMode)
    {
        try
        {
            // 你的测试逻辑代码
            // ...
        }
        catch
        {
            StopOnFailureMemberDataAttribute._hasTestFailed = true;
            throw;
        }
    }

    // 在测试类初始化时重置状态
    [CollectionFixtureSetUp]
    public void ResetState()
    {
        StopOnFailureMemberDataAttribute.ResetFailureFlag();
    }
}

这种方式更灵活，能直接控制参数的提供逻辑，但需要注意全局静态变量的状态重置，避免影响其他测试。

方式三：命令行全局停止 #

如果希望整个测试套件遇到第一个失败就停止运行，可以在执行测试时添加--stop-on-failure参数：

dotnet test --stop-on-failure

这种方式会终止所有后续测试，不仅仅是当前Theory的剩余用例，适合需要快速定位首个失败点的场景。

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