ASP.NET Core6+中如何让WebApplicationFactory排除指定初始化代码？

Microsoft.AspNetCore.Mvc.Testing.WebApplicationFactory用于在内存中启动ASP.NET Core应用执行单元测试，在ASP.NET Core 3.x/5的旧模式下，它会自动调用public static IHostBuilder CreateHostBuilder方法；但改用WebApplicationBuilder后，测试时WebApplicationFactory会直接执行Program.Main方法。

当前遇到的问题：Program.Main中包含不想在单元测试中执行的逻辑——从appsettings.json和appsettings.ASPNETCORE_ENVIRONMENT.json加载Serilog配置，这部分操作在WebApplication.CreateBuilder之前执行，无法通过WebApplicationFactory干预，导致测试场景下加载无用的生产日志配置。

想明确三个问题：

• 是否有办法让WebApplicationFactory选择其他入口点，跳过这些基础设施代码？
• 是否必须退回到旧的Program/Startup模式？
• 我的需求本身是否存在问题，需要重新考虑是否要在测试中排除这些代码？

解决方案 #

1. 通过环境变量区分测试环境，跳过生产日志初始化 #

在ConfigureLogging方法中检测当前环境，若为测试环境则使用极简日志配置，跳过配置文件加载：

private static void ConfigureLogging()
{
    var environment = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Production";
    
    if (environment == "Test")
    {
        // 测试环境使用极简日志，避免加载配置文件
        Log.Logger = new LoggerConfiguration()
            .MinimumLevel.Warning()
            .WriteTo.Console()
            .CreateLogger();
        return;
    }

    var configuration = new ConfigurationBuilder()
        .AddJsonFile("appsettings.json")
        .AddJsonFile($"appsettings.{environment}.json", optional: true)
        .AddEnvironmentVariables()
        .Build();
    Log.Logger = new LoggerConfiguration()
            .ReadFrom.Configuration(configuration)
            .Enrich.FromLogContext()
            // 生产环境日志配置
            .CreateLogger();
}

结合你已实现的MyWebApplicationFactory中builder.UseEnvironment("Test")的设置，测试时会自动触发测试日志逻辑。

2. 提取核心应用构建逻辑，供测试直接调用 #

将Main中除日志初始化外的核心构建逻辑抽为公共方法，测试时绕过Main直接调用该方法：

public class Program
{
    public static int Main(string[] args)
    {
        ConfigureLogging();

        try
        {
            BuildAndRunApp(args);
        }
        catch (Exception ex)
        {
            Log.Fatal(ex, "Host terminated unexpectedly");
            return 1;
        }
        finally
        {
            Log.CloseAndFlush();
        }

        return 0;
    }

    // 暴露公共方法，供测试场景调用
    public static WebApplication BuildAndRunApp(string[] args)
    {
        var builder = WebApplication.CreateBuilder(args);
        _ = builder.Host.UseSerilog();
        _ = builder.Services.AddControllers().AddJsonOptions(...);
        // 其他服务注册逻辑

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

        Dependencies.Register(container, app.Configuration);
        container.Verify();
        
        app.Run();
        return app;
    }

    private static void ConfigureLogging()
    {
        // 原日志配置逻辑
    }
}

同时重写WebApplicationFactory的CreateHost方法，自定义测试环境的配置与日志：

internal class MyWebApplicationFactory : WebApplicationFactory<Program>
{
    private readonly Dictionary<string, string?> _appConfig;
    public IConfiguration? Configuration { get; private set; }

    public MyWebApplicationFactory(SqlSettings sqlSettings)
    {
        _appConfig = new Dictionary<string, string?>
        {
            { "SqlSettings:ConnectionString", sqlSettings.ConnectionString },
        };
    }

    protected override IHost CreateHost(IHostBuilder builder)
    {
        builder.ConfigureAppConfiguration(config =>
        {
            config.Sources.Clear();
            Configuration = new ConfigurationBuilder()
                .AddInMemoryCollection(_appConfig)
                .Build();
            config.AddConfiguration(Configuration);
        });

        builder.UseEnvironment("Test");
        // 替换测试环境日志配置
        builder.ConfigureServices(services =>
        {
            services.AddLogging(logging =>
            {
                logging.ClearProviders();
                logging.AddConsole();
            });
        });

        return base.CreateHost(builder);
    }
}

3. 保留CreateHostBuilder方法兼容测试逻辑 #

无需完全退回旧模式，只需在Program中添加CreateHostBuilder方法，WebApplicationFactory会优先调用该方法而非Main：

public class Program
{
    public static int Main(string[] args)
    {
        ConfigureLogging();

        try
        {
            CreateHostBuilder(args).Build().Run();
        }
        catch (Exception ex)
        {
            Log.Fatal(ex, "Host terminated unexpectedly");
            return 1;
        }
        finally
        {
            Log.CloseAndFlush();
        }

        return 0;
    }

    // 添加该方法，供WebApplicationFactory优先调用
    public static IHostBuilder CreateHostBuilder(string[] args) =>
        WebApplication.CreateBuilder(args).Host;

    private static void ConfigureLogging()
    {
        // 原日志配置逻辑
    }
}

这样测试时WebApplicationFactory会直接调用CreateHostBuilder，绕过Main中的日志初始化，你可以在ConfigureWebHost中完全控制测试环境的配置与日志。

需求合理性说明 #

不需要退回到旧模式，上述方法均可解决问题。测试中排除生产日志配置是合理的：测试场景无需生产级别的日志输出，既可以避免不必要的文件IO和配置加载，也能让测试逻辑更简洁。

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