.NET 6集成测试：IClassFixture<WebApplicationFactory>替代方案及报错排查

问题背景 #

我曾在.NET Core 3的集成测试中使用IClassFixture<WebApplicationFactory>，现在需要为.NET 6项目编写集成测试，请问应当使用什么替代IClassFixture<WebApplicationFactory>？

我尝试编写的代码如下：

public class TicketControllerTests : IClassFixture<WebApplicationFactory<Program>>
{
    private readonly HttpClient _client;
    public TicketControllerTests(WebApplicationFactory<Program> factory)
    {
        _client = factory.CreateDefaultClient();
    }

    [Fact]
    public async Task Get()
    {
        var response = await _client.GetAsync("/Tickets/Test");

        //Assert
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
    }
}

运行代码时出现错误：无法从程序集“你的Web项目程序集名称”中加载类型“Program”

解决方案 #

首先明确：在.NET 6中依然可以正常使用IClassFixture<WebApplicationFactory>，你遇到的错误并非因为该接口过时，而是.NET 6的顶级语句特性导致Program类默认是内部（internal）访问级别，测试项目无法跨程序集访问它。

方法1：显式暴露Program类 #

在Web项目的Program.cs末尾添加一行代码，将默认的内部Program类改为公共可访问：

// 你的Web项目顶级语句代码...

// 添加此行，让Program类变为公共类型
public partial class Program { }

修改后，测试项目就能正常加载Program类型，原测试代码无需改动即可运行。

方法2：使用无泛型参数的WebApplicationFactory #

如果不想修改Web项目的代码，可以使用无泛型参数的WebApplicationFactory，通过WithWebHostBuilder手动配置测试环境：

public class TicketControllerTests : IClassFixture<WebApplicationFactory>
{
    private readonly HttpClient _client;
    public TicketControllerTests(WebApplicationFactory factory)
    {
        _client = factory.WithWebHostBuilder(builder =>
        {
            // 直接配置测试用的服务和中间件
            builder.ConfigureServices(services =>
            {
                // 例如替换测试用的服务依赖
            });
        }).CreateDefaultClient();
    }

    [Fact]
    public async Task Get()
    {
        var response = await _client.GetAsync("/Tickets/Test");
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
    }
}

不过这种方式灵活性较低，更推荐配合方法1使用，以复用Web项目的启动逻辑。

核心原因说明 #

.NET 6引入的最小API（顶级语句）语法会自动生成内部的Program类，而测试项目通常是独立的程序集，默认无法访问其他程序集的内部类型，这才是导致加载失败的根本原因，和IClassFixture接口本身无关——该接口仍是xUnit中实现集成测试共享上下文的标准方案。

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