ASP.NET Core 6无公开入口点时如何使用WebApplicationFactory配置集成测试

针对顶级语句生成的非公开Program类无法被WebApplicationFactory<T>引用的问题，有两种常用解决方案：

方案1：显式声明公开Program类（推荐） #

在Web项目的Program.cs文件末尾追加一行分部类声明，即可将隐式生成的Program类改为公开状态：

// Program.cs原有逻辑
var builder = WebApplication.CreateBuilder(args);
// 服务注册逻辑
builder.Services.AddControllers();
// ...其他配置

var app = builder.Build();
// 中间件配置逻辑
app.MapControllers();
// ...其他配置

app.Run();

// 新增以下代码即可
public partial class Program { }

修改后测试项目可直接引用Program类作为WebApplicationFactory的泛型参数。

方案2：通过InternalVisibleTo特性开放内部访问权限 #

如果不想修改Program.cs代码，可以在Web项目的配置文件（.csproj）中添加内部访问权限声明，允许测试项目访问Web项目的内部类：

<ItemGroup>
  <!-- 替换为你的测试项目的程序集名称 -->
  <InternalsVisibleTo Include="YourTestProjectName" />
</ItemGroup>

配置后无需修改Program.cs，测试项目即可访问默认生成的internal级别的Program类。

测试代码示例 #

完成上述任意一种配置后，即可按照原有逻辑编写集成测试：

1. 自定义WebApplicationFactory

public class TestWebApplicationFactory : WebApplicationFactory<Program>
{
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        // 可在此处重写测试环境的配置，例如替换数据库为内存数据库
        builder.ConfigureTestServices(services =>
        {
            // 示例：替换原有DbContext配置
            var dbContextDescriptor = services.SingleOrDefault(d => 
                d.ServiceType == typeof(DbContextOptions<AppDbContext>));
            if (dbContextDescriptor != null) services.Remove(dbContextDescriptor);
            
            services.AddDbContext<AppDbContext>(options =>
            {
                options.UseInMemoryDatabase("TestDatabase");
            });
        });
    }
}

2. 编写测试用例

// 以xUnit为例
public class ApiControllerTest : IClassFixture<TestWebApplicationFactory>
{
    private readonly HttpClient _testClient;

    public ApiControllerTest(TestWebApplicationFactory factory)
    {
        _testClient = factory.CreateClient();
    }

    [Fact]
    public async Task GetEndpoint_ReturnsOkStatus()
    {
        var response = await _testClient.GetAsync("/api/your-endpoint");
        response.EnsureSuccessStatusCode();
    }
}

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