ASP.NET Core 6 Web Api迁移数据库报StopTheHostException异常如何解决

你遇到的HostFactoryResolver.HostingListener.StopTheHostException是EF Core工具链的内置预期异常：执行迁移、数据库更新等设计时操作时，EF工具会启动应用宿主仅获取服务注册中的DbContext配置，拿到配置后就会抛出该异常提前终止宿主启动流程，不需要完整运行应用。你看到的致命错误日志是Serilog默认捕获了所有未处理异常导致的，并非真的出现程序运行故障。

以下两种方案均可解决日志报错问题：

方案1：全局异常过滤（最轻量） #

在Program.cs外层包裹异常捕获逻辑，专门过滤该预期异常，避免被Serilog记录为致命错误，修改后代码示例：

using Microsoft.Extensions.Hosting;

try
{
    Log.Information("Application Is Starting");

    var builder = WebApplication.CreateBuilder(args);

    // 以下保留你原有的服务注册逻辑
    builder.Host.UseSerilog((context, services, configuration) => configuration
        .ReadFrom.Configuration(context.Configuration)
        .ReadFrom.Services(services)
        .Enrich.FromLogContext());

    builder.Services.AddDbContext<LocalDbContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("localConnection"))
    );

    builder.Services.AddControllers();
    builder.Services.AddCors(options =>
    {
        options.AddPolicy("AllowAll", builder =>
            builder
                .AllowAnyOrigin()
                .AllowAnyMethod()
                .AllowAnyHeader()
            );
    });
    builder.Services.AddEndpointsApiExplorer();
    builder.Services.AddSwaggerGen();

    var app = builder.Build();

    // 以下保留你原有的中间件配置逻辑
    app.UseSerilogRequestLogging(configure =>
    {
        configure.MessageTemplate = "HTTP {RequestMethod} {RequestPath} ({UserId}) responded {StatusCode} in {Elapsed:0.0000}ms";
    });

    if (app.Environment.IsDevelopment())
    {
        app.UseSwagger();
        app.UseSwaggerUI();
    }

    app.UseCors("AllowAll");

    app.UseHttpsRedirection();

    app.UseAuthorization();

    app.MapControllers();

    app.Run();
}
// 专门捕获EF工具抛出的预期异常，不记录错误日志
catch (HostFactoryResolver.HostingListener.StopTheHostException)
{
    Log.Information("EF Core design-time operation completed, host stopped as expected");
}
catch (Exception ex)
{
    Log.Fatal(ex, "Application terminated unexpectedly");
}
finally
{
    Log.CloseAndFlush();
}

方案2：添加设计时DbContext工厂（更彻底） #

新增实现IDesignTimeDbContextFactory<LocalDbContext>接口的工厂类，EF工具会优先使用该工厂获取DbContext配置，不需要启动完整应用宿主，从根源避免该异常抛出：

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Design;
using Microsoft.Extensions.Configuration;
using System.IO;

public class LocalDbContextFactory : IDesignTimeDbContextFactory<LocalDbContext>
{
    public LocalDbContext CreateDbContext(string[] args)
    {
        IConfiguration configuration = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json")
            .Build();

        var optionsBuilder = new DbContextOptionsBuilder<LocalDbContext>();
        optionsBuilder.UseSqlServer(configuration.GetConnectionString("localConnection"));

        return new LocalDbContext(optionsBuilder.Options);
    }
}

该异常不会对项目正常运行产生任何影响：仅在执行EF Core设计时命令（Add-Migration、Update-Database等）时触发，应用正常启动、处理业务请求的流程中完全不会抛出该异常，也不存在任何潜在副作用。

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