发布ASP.NET项目时dbContext.Database.Migrate()引发HTTP Error 500.30求助

本地使用Visual Studio运行ASP.NET项目无任何异常，但发布到ASP.NET服务器后，dbContext.Database.Migrate()代码引发了HTTP Error 500.30错误。项目的Program.cs代码如下：

using DataConnection.Areas.Identity;
using DataConnection.Data;
using Microsoft.AspNetCore.Components.Authorization;
using Microsoft.AspNetCore.Identity;
using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(connectionString));
builder.Services.AddDatabaseDeveloperPageExceptionFilter();
builder.Services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
    .AddEntityFrameworkStores<ApplicationDbContext>();
builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();
builder.Services.AddScoped<AuthenticationStateProvider, RevalidatingIdentityAuthenticationStateProvider<IdentityUser>>();
builder.Services.AddSingleton<WeatherForecastService>();

var app = builder.Build();

// CAUSING HTTP ERROR 500.30:
using (var scope = app.Services.CreateScope())
{
    var dbContext = scope.ServiceProvider.GetRequiredService<ApplicationDbContext>();
    dbContext.Database.Migrate();
}

if (app.Environment.IsDevelopment())
{
    app.UseMigrationsEndPoint();
}
else
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseStaticFiles();

app.UseRouting();

app.UseAuthentication();
app.UseAuthorization();

app.MapControllers();
app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

app.Run();

可能的原因及解决步骤 #

1. 检查数据库连接账号权限 #

• 服务器SQL Server中，连接字符串对应的账号必须具备数据库schema创建/修改权限（比如分配db_owner角色）。本地开发账号权限通常足够，但生产环境账号可能被限制，导致Migrate无法执行。
• 确认生产环境配置文件（如appsettings.Production.json）中的连接字符串正确，避免和开发环境的本地数据库地址混淆。

2. 添加错误捕获并调整Migrate逻辑 #

当前代码未捕获迁移异常，一旦出错直接导致应用启动失败。建议添加日志记录和异常处理，避免应用崩溃：

var app = builder.Build();

using (var scope = app.Services.CreateScope())
{
    var dbContext = scope.ServiceProvider.GetRequiredService<ApplicationDbContext>();
    var logger = scope.ServiceProvider.GetRequiredService<ILogger<Program>>();
    try
    {
        dbContext.Database.Migrate();
        logger.LogInformation("数据库迁移执行成功");
    }
    catch (Exception ex)
    {
        logger.LogError(ex, "数据库迁移失败，请检查权限或连接字符串");
        // 生产环境可根据业务需求决定是否终止应用，建议先记录日志再排查
        // throw;
    }
}

3. 验证服务器.NET运行时版本 #

确保服务器安装的.NET运行时版本与项目目标框架完全匹配（比如项目用.NET 6，服务器必须安装.NET 6 Runtime），版本不匹配会导致启动类错误。

4. 检查IIS应用程序池权限 #

• 如果使用集成身份验证连接SQL Server，需确保应用程序池的身份账号有权限访问目标数据库。
• 若使用SQL Server账号，确认账号密码在生产环境配置中正确，且该账号能被服务器网络访问。

5. 生产环境推荐手动执行迁移脚本 #

自动Migrate在生产环境风险较高，建议本地生成迁移脚本后手动在服务器执行：

# 生成从初始到最新的迁移脚本
dotnet ef migrations script -o migration.sql

将生成的migration.sql文件在服务器的SQL Server中执行，避免启动时因迁移失败导致应用无法访问。

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