.NET Core 6中连接字符串验证通过后如何执行数据库迁移？

核心思路 #

将EF Core迁移逻辑从应用启动流程中剥离，转移到验证数据库连接的业务接口中，确保只有在连接验证通过、配置文件更新完成后，才手动触发迁移操作。

1. 调整Program.cs，移除启动时的强制迁移逻辑 #

修改应用启动代码，仅注册DbContext服务，不在启动阶段执行迁移，避免因初始连接字符串为空导致启动失败：

var builder = WebApplication.CreateBuilder(args);

// 注册DbContext，使用配置文件中的连接字符串（初始为空不影响注册）
builder.Services.AddDbContext<YourDataContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("myconn")));

// 其他服务注册、中间件配置...

var app = builder.Build();

// 此处不再执行迁移操作

app.Run();

2. 在验证接口中完成连接校验、配置写入与迁移 #

创建处理数据库配置的接口，在接口内完成全流程操作：

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

[ApiController]
[Route("setup")]
public class SetupController : ControllerBase
{
    private readonly IConfiguration _configuration;
    private readonly IServiceProvider _serviceProvider;

    public SetupController(IConfiguration configuration, IServiceProvider serviceProvider)
    {
        _configuration = configuration;
        _serviceProvider = serviceProvider;
    }

    [HttpPost("apply")]
    public async Task<IActionResult> ApplyDbSettings([FromBody] DbConfigInput input)
    {
        // 1. 构建临时连接字符串并验证连接
        var tempConnStr = $"Server={input.Server};Database={input.DbName};User Id={input.Username};Password={input.Password};TrustServerCertificate=True;";
        var tempOptions = new DbContextOptionsBuilder<YourDataContext>()
            .UseSqlServer(tempConnStr)
            .Options;

        try
        {
            using var tempContext = new YourDataContext(tempOptions);
            if (!await tempContext.Database.CanConnectAsync())
            {
                return BadRequest("数据库连接失败，请检查输入信息");
            }
        }
        catch (Exception ex)
        {
            return BadRequest($"连接验证出错：{ex.Message}");
        }

        // 2. 更新appsettings.json中的连接字符串
        var appSettingsPath = Path.Combine(Directory.GetCurrentDirectory(), "appsettings.json");
        var jsonContent = await File.ReadAllTextAsync(appSettingsPath);
        var jsonObj = Newtonsoft.Json.JsonConvert.DeserializeObject<Newtonsoft.Json.Linq.JObject>(jsonContent);
        
        jsonObj["ConnectionStrings"]["myconn"] = tempConnStr;
        await File.WriteAllTextAsync(appSettingsPath, jsonObj.ToString(Newtonsoft.Json.Formatting.Indented));

        // 3. 执行数据库迁移
        using var scope = _serviceProvider.CreateScope();
        var dbContext = scope.ServiceProvider.GetRequiredService<YourDataContext>();
        await dbContext.Database.MigrateAsync();

        // 可选：重启应用以确保后续请求使用新配置
        // _serviceProvider.GetRequiredService<IHostApplicationLifetime>().StopApplication();

        return Ok("数据库配置已生效，迁移执行完成");
    }
}

// 接收用户输入的模型
public class DbConfigInput
{
    public string Server { get; set; }
    public string DbName { get; set; }
    public string Username { get; set; }
    public string Password { get; set; }
}

3. 关键注意点 #

• 确保appsettings.json文件具备写入权限，生产环境部署时需调整文件权限设置
• 若使用System.Text.Json替代Newtonsoft.Json，需修改对应的JSON序列化逻辑
• 迁移操作通过创建服务范围获取DbContext，确保使用最新更新的连接字符串
• 若需让应用立即使用新配置，可调用IHostApplicationLifetime.StopApplication()触发重启，需配合部署环境的自动重启机制

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