.NET 6中Razor页面HTML渲染测试报错，求解决方法

这个错误核心原因是测试类或WebApplicationFactory派生类缺少合适的构造函数，或是测试框架（如NUnit）无法正确初始化测试依赖，以下是具体解决步骤：

1. 确保WebApplicationFactory派生类构造正确 #

如果自定义了WebApplicationFactory，必须保留无参构造函数，示例：

public class CustomWebAppFactory : WebApplicationFactory<Program>
{
    // 必须保留无参构造，让测试框架能实例化
    public CustomWebAppFactory() {}

    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        // 按需配置测试用服务，比如替换数据库为内存库
        builder.ConfigureServices(services =>
        {
            var descriptor = services.SingleOrDefault(d => d.ServiceType == typeof(DbContextOptions<AppDbContext>));
            if (descriptor != null) services.Remove(descriptor);
            services.AddDbContext<AppDbContext>(options => options.UseInMemoryDatabase("TestDb"));
        });
    }
}

注意：.NET6的Program类默认是internal，需要在项目的Program.cs末尾添加public partial class Program { }，让测试项目能访问到它。

2. 修正测试类的初始化逻辑 #

如果使用NUnit，测试类不能有带参数的构造函数，需将依赖初始化放在[OneTimeSetUp]方法中：

[TestFixture]
public class HomePageTests
{
    private WebApplicationFactory<Program> _factory;
    private HttpClient _client;

    [OneTimeSetUp]
    public void InitTest()
    {
        _factory = new CustomWebAppFactory();
        _client = _factory.CreateClient();
    }

    [Test]
    public async Task H1_Text_Matches_Expected()
    {
        // 请求目标Razor页面
        var response = await _client.GetAsync("/");
        response.EnsureSuccessStatusCode();
        var htmlContent = await response.Content.ReadAsStringAsync();

        // 用AngleSharp解析HTML
        var browsingContext = BrowsingContext.New(Configuration.Default);
        var document = await browsingContext.OpenAsync(req => req.Content(htmlContent));
        var h1Text = document.QuerySelector("h1")?.TextContent.Trim();

        // 验证文本正确性
        Assert.That(h1Text, Is.EqualTo("Les Amitiés Spirituelles"));
    }

    [OneTimeTearDown]
    public void CleanupTest()
    {
        _client.Dispose();
        _factory.Dispose();
    }
}

如果使用xUnit，建议通过IClassFixture注入WebApplicationFactory，避免手动初始化的构造问题：

public class HomePageTests : IClassFixture<WebApplicationFactory<Program>>
{
    private readonly HttpClient _client;

    // xUnit会自动注入WebApplicationFactory实例
    public HomePageTests(WebApplicationFactory<Program> factory)
    {
        _client = factory.CreateClient();
    }

    // 测试方法同上...
}

3. 匹配测试依赖版本 #

确保测试相关NuGet包版本与.NET6兼容，示例csproj配置：

<PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" Version="6.0.25" />
<PackageReference Include="NUnit" Version="3.13.3" />
<PackageReference Include="NUnit3TestAdapter" Version="4.4.2" />
<PackageReference Include="AngleSharp" Version="1.0.0" />

4. 检查测试框架特性使用规范 #

• NUnit的[OneTimeSetUp]方法必须是public、无参数、非静态的，否则测试框架无法识别执行
• 不要在测试类的构造函数中初始化WebApplicationFactory这类重资源，统一放在[OneTimeSetUp]或xUnit的构造/Fixture中

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