使用EF MigrateAsync()导致所有控制器返回404 Not Found问题求助

这问题的核心原因其实很简单——你在ASP.NET Core的Configure方法里用了async void，这完全违背了框架的异步启动设计逻辑。

为什么同步迁移能正常运行？ #

当你用同步的context.Database.Migrate()时，虽然Configure是async void，但同步方法会阻塞当前线程，直到迁移完全完成后才会继续执行后续的中间件配置逻辑。这相当于"巧合"地让迁移在应用接受请求前完成了，所以看起来一切正常。

为什么异步迁移会导致全局404？ #

换成await context.Database.MigrateAsync()后，async void的特性就开始捣乱了：

• ASP.NET Core框架无法跟踪async void方法的完成状态，它会把这个方法当作同步方法执行，一遇到await就直接继续往下走，根本不等迁移完成。
• 更糟的是，async void的异常会直接抛到线程池，可能导致启动流程中的中间件（比如路由）没有正确初始化完成，甚至整个应用的启动状态异常。这就是为什么连不需要数据库的ping接口都返回404——路由系统根本没被正确注册好。

正确的修复方案 #

你需要把数据库迁移的逻辑从Configure方法中移出来，放到应用启动流程的正确位置，确保迁移完成后再启动应用接受请求。在ASP.NET Core 6+的Program.cs中，正确的写法应该是这样：

var builder = WebApplication.CreateBuilder(args);

// 注册你的DbContext和其他服务
builder.Services.AddDbContext<Context>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
// ...其他服务注册

var app = builder.Build();

// 执行数据库迁移（这里可以安全地用异步方法）
using (var scope = app.Services.CreateScope())
{
    var serviceProvider = scope.ServiceProvider;
    try
    {
        var context = serviceProvider.GetRequiredService<Context>();
        await context.Database.MigrateAsync();
    }
    catch (Exception ex)
    {
        // 这里可以添加日志记录，处理迁移失败的情况
        var logger = serviceProvider.GetRequiredService<ILogger<Program>>();
        logger.LogError(ex, "数据库迁移过程中发生异常");
        throw;
    }
}

// 配置中间件（这部分和你原来的Configure逻辑一致）
if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}

app.UseRouting();
app.MapControllers();
// ...其他中间件配置

// 启动应用
await app.RunAsync();

额外提醒 #

永远不要在ASP.NET Core的启动方法（比如Configure、ConfigureServices）中使用async void——这类方法要么是同步的，要么如果需要异步逻辑，就应该用框架提供的异步启动机制（比如上面这种在RunAsync前执行异步操作的方式）。async void是专门为UI事件处理设计的，在后端服务中几乎没有合适的使用场景，只会带来各种难以排查的异步问题。

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