XUnit：集合中若有测试失败，如何终止后续测试？

针对你用WebApplicationFactory做API集成测试、需要顺序执行且前序失败则终止后续的场景，目前有几个实用方案：

方案一：共享上下文标记+动态跳过（推荐，实现简单） #

利用XUnit的集合共享Fixture，在Fixture中维护一个失败状态标记，每个测试执行前先检查该标记，若已触发则直接跳过当前测试。

步骤1：定义共享集合与Fixture #

// 集合定义，用于绑定测试类到同一共享上下文
[CollectionDefinition("SequentialApiTests")]
public class SequentialTestCollection : ICollectionFixture<ApiTestFixture>
{
    // 空实现，仅用于标记集合
}

// 继承WebApplicationFactory的共享Fixture，维护失败状态
public class ApiTestFixture : WebApplicationFactory<Program>
{
    // 标记是否有前序测试失败
    public bool HasFailedTest { get; set; } = false;
}

步骤2：编写顺序测试类 #

每个测试执行前检查失败标记，若已失败则抛出SkipException跳过；测试过程中捕获异常，设置失败标记后再抛出。

[Collection("SequentialApiTests")]
public class EndToEndApiTests
{
    private readonly ApiTestFixture _factory;
    private readonly HttpClient _client;

    public EndToEndApiTests(ApiTestFixture factory)
    {
        _factory = factory;
        _client = factory.CreateClient();
    }

    [Fact, TestOrder(1)]
    public async Task Test1_CreateSampleResource()
    {
        // 检查前序失败状态
        if (_factory.HasFailedTest)
            throw new SkipException("前序测试失败，跳过当前测试");

        try
        {
            // 测试逻辑：创建资源
            var requestContent = new StringContent(JsonSerializer.Serialize(new { Name = "Test" }), Encoding.UTF8, "application/json");
            var response = await _client.PostAsync("/api/resources", requestContent);
            response.EnsureSuccessStatusCode();
        }
        catch
        {
            // 标记失败状态
            _factory.HasFailedTest = true;
            throw;
        }
    }

    [Fact, TestOrder(2)]
    public async Task Test2_UpdateSampleResource()
    {
        if (_factory.HasFailedTest)
            throw new SkipException("前序测试失败，跳过当前测试");

        try
        {
            // 测试逻辑：更新资源
            var requestContent = new StringContent(JsonSerializer.Serialize(new { Name = "UpdatedTest" }), Encoding.UTF8, "application/json");
            var response = await _client.PutAsync("/api/resources/1", requestContent);
            response.EnsureSuccessStatusCode();
        }
        catch
        {
            _factory.HasFailedTest = true;
            throw;
        }
    }

    // 后续测试重复上述模式
}

方案二：自定义测试运行器（彻底终止，复杂度高） #

如果需要在测试失败后直接终止整个测试集合的运行，而非跳过后续测试，可以自定义XUnit的测试运行器。核心思路是继承XunitTestRunner，在运行每个测试前检查是否已有失败记录，若有则终止整个集合的执行。

核心实现要点 #

1. 实现自定义的ITestRunner，重写测试执行逻辑，维护全局失败状态。
2. 在测试项目中配置使用自定义运行器（通过xunit.runner.json或代码注册）。

这种方式需要对XUnit的运行机制有一定了解，适合对测试执行流程有严格控制需求的场景。

方案三：合并为单测试（简单但不推荐） #

如果测试步骤强依赖且不需要单独执行，可以把所有步骤合并到一个Fact中，分步执行断言，前面的断言失败后后续步骤自然不会执行。例如：

[Fact]
public async Task FullEndToEndFlow()
{
    var client = _factory.CreateClient();

    // 步骤1：创建资源
    var createContent = new StringContent(JsonSerializer.Serialize(new { Name = "Test" }), Encoding.UTF8, "application/json");
    var createResponse = await client.PostAsync("/api/resources", createContent);
    createResponse.EnsureSuccessStatusCode();

    // 步骤2：更新资源（仅步骤1成功才执行）
    var updateContent = new StringContent(JsonSerializer.Serialize(new { Name = "UpdatedTest" }), Encoding.UTF8, "application/json");
    var updateResponse = await client.PutAsync("/api/resources/1", updateContent);
    updateResponse.EnsureSuccessStatusCode();

    // 后续步骤...
}

缺点是无法单独运行某个步骤，测试报告粒度较粗，不利于定位问题。

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