.NET Core 6 Web API：KeyVault替换AppSettings的加载时机问题

问题背景 #

开发.NET Core 6 Web API时，通过Azure KeyVault管理配置，已在CreateAppConfiguration中调用AddAzureKeyVault，但在Startup.cs的ConfigureServices方法中获取数据库连接字符串时，仍拿到appsettings文件中的虚拟值；后续控制器方法中却能正常获取KeyVault的真实值。目前通过手动获取KeyVault连接字符串实现功能，需更优的提前加载方案。

解决方案 #

核心原因是Azure KeyVault配置默认采用延迟加载机制，ConfigureServices执行初期还未完成KeyVault配置的加载。以下两种方案可解决该问题：

方法一：强制立即加载所有KeyVault配置 #

在ConfigureAppConfiguration流程中，完成KeyVault配置添加后，强制构建配置实例，确保后续流程能直接获取到KeyVault中的值。

修改Program.cs代码：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
       .ConfigureAppConfiguration((context, config) =>
       {
           // 先构建基础配置，获取KeyVault地址等信息
           var baseConfig = config.Build();
           var vaultUrl = baseConfig["KeyVault:VaultUrl"];
           var credential = new DefaultAzureCredential();
           
           // 添加Azure KeyVault配置源
           config.AddAzureKeyVault(new Uri(vaultUrl), credential, new PrefixKeyVaultSecretManager("KVTest"));
           
           // 强制构建最终配置，触发KeyVault配置加载
           var finalConfig = config.Build();
           context.Configuration = finalConfig;
       })
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

方法二：使用配置委托延迟获取连接字符串 #

不提前加载配置，而是在注册DbContext时采用委托方式，让框架在实际需要配置时（此时KeyVault已完成加载）再获取连接字符串，更符合.NET Core的配置设计逻辑。

修改Startup.cs代码：

public void ConfigureServices(IServiceCollection services)
{
    // 通过服务提供者延迟获取配置，此时KeyVault值已加载完成
    services.AddPooledDbContextFactory<ICAdminContext>((serviceProvider, options) =>
    {
        var configuration = serviceProvider.GetRequiredService<IConfiguration>();
        var connString = configuration.GetConnectionString("InformCoreDbContext");
        
        options.UseSqlServer(connString, sqlOptions =>
        {
            sqlOptions.EnableRetryOnFailure();
        });
    });
}

方案对比 #

• 方法一：适合ConfigureServices早期就需要使用KeyVault配置的场景，但会增加启动时间（需提前拉取所有KeyVault密钥）。
• 方法二：遵循延迟加载原则，性能更优，无需修改配置加载流程，推荐优先使用。

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