.NET Core中XUnit IClassFixture执行两次：TestHostBuilder无法跨测试类共享实例的问题

首先，你遇到的核心问题是：IClassFixture<T>是为每个测试类创建一个Fixture实例，所以两个测试类会分别初始化一次TestHostBuilder。而你尝试的集合夹具（Collection Fixture）是正确的方向，但大概率是配置步骤遗漏了，导致没生效。

为什么你的集合夹具没生效？ #

xUnit的集合夹具需要严格遵循三个步骤，缺一不可：

1. 创建一个集合标记类，关联你的Fixture
2. 在所有需要共享Fixture的测试类上标记[Collection]特性
3. 确保你的Fixture类实现完整的生命周期接口（IAsyncLifetime的两个方法都要实现）

正确的配置步骤 #

1. 创建集合定义类

先定义一个空类，用[CollectionDefinition]标记它，指定集合名称，并实现ICollectionFixture<TestHostBuilder>：

[CollectionDefinition("SharedTestHostCollection")]
public class SharedTestHostCollection : ICollectionFixture<TestHostBuilder>
{
    // 这个类不需要任何业务代码，仅作为集合的标记载体
}

2. 修改测试类，移除IClassFixture并添加集合标记

把两个测试类上的IClassFixture<TestHostBuilder>接口移除，换成[Collection]特性，指定和集合定义类一致的名称：

[Collection("SharedTestHostCollection")]
public class ClientAppSettingControllerTests
{
    private readonly TestHostBuilder _fixture;

    public ClientAppSettingControllerTests(TestHostBuilder fixture)
    {
        _fixture = fixture;
    }

    [Fact]
    public async Task ExampleTest()
    {
        // 你的测试逻辑
    }
}

[Collection("SharedTestHostCollection")]
public class DraftControllerTests
{
    private readonly TestHostBuilder _fixture;

    public DraftControllerTests(TestHostBuilder fixture)
    {
        _fixture = fixture;
    }

    [Fact]
    public async Task AnotherTest()
    {
        // 你的测试逻辑
    }
}

3. 完善TestHostBuilder的生命周期实现

你提供的代码只实现了InitializeAsync，还需要补充DisposeAsync方法来清理资源，同时确保RavenTestDriver的清理逻辑被调用：

public class TestHostBuilder : RavenTestDriver, IAsyncLifetime
{
    public IHost Host { get; private set; }
    public IDocumentStore DocumentStore { get; private set; }

    public async Task InitializeAsync()
    {
        DocumentStore = GetDocumentStore();
        var hostBuilder = easy.api.Program.CreateHostBuilder(Array.Empty<string>())
            .ConfigureWebHost(webHostBuilder => webHostBuilder.UseTestServer())
            .ConfigureServices(services =>
            {
                services.AddScoped<ICurrentUserService, InitRequest>();
                services.AddScoped<ICacheStorage>(_ => new Mock<ICacheStorage>().Object);
                services.AddRavenDbAsyncSession(DocumentStore);
                services.AddTransient<IAsyncDocumentSession>(c => DocumentStore.OpenAsyncSession());
            });

        Host ??= await hostBuilder.StartAsync();
    }

    public async Task DisposeAsync()
    {
        // 清理Host资源
        if (Host != null)
        {
            await Host.StopAsync();
            Host.Dispose();
        }

        // 清理RavenDB资源
        DocumentStore?.Dispose();
        Cleanup(); // RavenTestDriver内置的清理方法
    }
}

常见的坑点排查 #

如果按上面配置后还是多次初始化，检查以下几点：

• 集合名称拼写一致：确保[CollectionDefinition]和测试类的[Collection]特性里的字符串完全相同（大小写敏感）
• Fixture类有无参构造：xUnit要求集合夹具类必须有公共无参构造函数，如果你给TestHostBuilder加了带参数的构造，会导致xUnit无法共享实例
• 不要同时用IClassFixture和集合标记：如果测试类还保留了IClassFixture<TestHostBuilder>接口，xUnit会优先按类Fixture处理，忽略集合配置
• 测试类是否在同一个集合：只有标记了同一个集合名称的测试类才会共享Fixture

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