ASP.Net Core 2.0应用启动时条件检查的推荐时机与位置

嘿，这个需求太实用了——谁都不想等用户发起请求才发现数据库连不上或者依赖服务挂了对吧？在ASP.NET Core 2.0里，有几个靠谱的时机和位置来做这类预启动检查，我给你梳理一下：

1. Program.cs 中 WebHost 构建后、启动前 #

这是最直接的位置，完全在应用开始接收请求之前执行检查，一旦失败直接终止应用，不会对外提供服务。

你可以在BuildWebHost之后、Run之前，创建服务范围来获取需要测试的组件（比如DbContext、仓储或其他服务），执行健康检查：

public static void Main(string[] args)
{
    var webHost = BuildWebHost(args);
    
    // 执行预启动检查
    using (var scope = webHost.Services.CreateScope())
    {
        var services = scope.ServiceProvider;
        try
        {
            // 测试数据库连接：执行简单查询验证连通性
            var dbContext = services.GetRequiredService<YourDbContext>();
            dbContext.Database.ExecuteSqlCommand("SELECT 1");
            
            // 测试其他依赖服务，比如调用健康检查方法
            var externalService = services.GetRequiredService<IExternalDependency>();
            if (!externalService.IsHealthy())
            {
                throw new InvalidOperationException("外部依赖服务不可用");
            }
        }
        catch (Exception ex)
        {
            // 记录错误日志
            var logger = services.GetRequiredService<ILogger<Program>>();
            logger.LogCritical(ex, "预启动检查失败，应用无法启动");
            
            // 直接退出应用，避免服务带病运行
            Environment.Exit(1);
        }
    }
    
    webHost.Run();
}

2. Startup.cs 的 Configure 方法末尾 #

Configure方法是配置中间件的阶段，在所有中间件配置完成后，应用即将开始处理请求前，你可以在这里添加检查逻辑。同样通过创建服务范围来获取依赖：

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
    // 常规中间件配置（比如MVC、静态文件等）
    app.UseStaticFiles();
    app.UseMvc();
    
    // 执行启动检查
    using (var scope = app.ApplicationServices.CreateScope())
    {
        var services = scope.ServiceProvider;
        try
        {
            var dbContext = services.GetRequiredService<YourDbContext>();
            // 也可以用EnsureCreated来验证数据库是否存在（根据你的需求选择）
            dbContext.Database.EnsureCreated();
            
            var paymentService = services.GetRequiredService<IPaymentService>();
            if (!paymentService.CheckHealth())
            {
                throw new Exception("支付服务健康检查失败");
            }
        }
        catch (Exception ex)
        {
            var logger = loggerFactory.CreateLogger<Startup>();
            logger.LogCritical(ex, "启动检查未通过");
            Environment.Exit(1);
        }
    }
}

⚠️ 注意：ASP.NET Core 2.0的Configure方法默认是同步的，如果你的检查需要异步操作，得把异步逻辑包装成同步（比如用.GetAwaiter().GetResult()），或者考虑下面的IHostedService方案。

3. 使用 IHostedService 实现异步启动检查 #

如果你的依赖检查需要异步操作（比如调用异步的健康检查接口、异步数据库查询），IHostedService是更合适的选择。它的StartAsync方法会在应用启动后、处理请求前执行，天然支持异步：

首先实现一个自定义的HostedService：

public class StartupHealthChecker : IHostedService
{
    private readonly IServiceProvider _serviceProvider;
    private readonly ILogger<StartupHealthChecker> _logger;

    public StartupHealthChecker(IServiceProvider serviceProvider, ILogger<StartupHealthChecker> logger)
    {
        _serviceProvider = serviceProvider;
        _logger = logger;
    }

    public async Task StartAsync(CancellationToken cancellationToken)
    {
        using (var scope = _serviceProvider.CreateScope())
        {
            var services = scope.ServiceProvider;
            try
            {
                // 异步测试数据库连接
                var dbContext = services.GetRequiredService<YourDbContext>();
                await dbContext.Database.ExecuteSqlCommandAsync("SELECT 1", cancellationToken);
                
                // 异步测试外部服务
                var notificationService = services.GetRequiredService<INotificationService>();
                var isHealthy = await notificationService.CheckHealthAsync(cancellationToken);
                if (!isHealthy)
                {
                    throw new InvalidOperationException("通知服务不可用");
                }
            }
            catch (Exception ex)
            {
                _logger.LogCritical(ex, "启动健康检查失败");
                Environment.Exit(1);
            }
        }
    }

    public Task StopAsync(CancellationToken cancellationToken)
    {
        return Task.CompletedTask;
    }
}

然后在Startup.cs的ConfigureServices中注册这个服务：

public void ConfigureServices(IServiceCollection services)
{
    // 其他服务注册...
    services.AddHostedService<StartupHealthChecker>();
}

这个方案的优势是代码结构清晰，符合依赖注入的最佳实践，完美支持异步场景。

总结选择建议 #

• 如果是简单的同步检查，Program.cs的启动前检查最直接高效；
• 如果需要异步操作，IHostedService是最优解；
• Configure方法适合小型项目或简单检查，但要注意同步限制。

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