ASP.NET Core 8集成测试：如何跳过Azure App Config直接使用测试配置

要解决测试时先加载Azure App Config导致的速度慢、CI验证失败问题，核心是从源头阻止Azure配置的加载，而非加载后再清空。推荐两种实用方案：

方案一：根据环境判断是否加载Azure App Config #

在主项目的Program.cs中，通过环境标识做判断，仅在非测试环境加载Azure配置：

var builder = WebApplication.CreateBuilder(args);

// 仅当当前环境不是"Test"时，才加载Azure App Config
if (!builder.Environment.IsEnvironment("Test"))
{
    builder.Configuration.AddAzureAppConfiguration(options =>
    {
        // 你的Azure App Config配置逻辑，比如连接字符串、筛选规则等
        options.Connect("你的Azure连接字符串")
               .Select(KeyFilter.Any, LabelFilter.Null);
    });
}

// 后续服务注册、中间件配置等逻辑...
var app = builder.Build();
// ...

然后在集成测试的WebApplicationFactory子类中，指定测试环境为"Test"并添加测试配置文件：

public class TestWebApplicationFactory : WebApplicationFactory<Program>
{
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        // 设置测试环境
        builder.UseEnvironment("Test");

        builder.ConfigureAppConfiguration((context, config) =>
        {
            // 添加测试专用配置文件，确保优先级足够高
            config.AddJsonFile("appsettings.test.json", optional: false, reloadOnChange: true);
        });
    }
}

测试运行时，Program.cs会识别到当前是Test环境，直接跳过Azure配置加载，完全使用本地测试配置。

方案二：通过配置开关控制Azure加载 #

如果不想依赖环境变量，可以在Program.cs中添加一个开关配置，仅当开关关闭时才加载Azure：

var builder = WebApplication.CreateBuilder(args);

// 读取是否跳过Azure配置的开关，默认不跳过
var skipAzureConfig = builder.Configuration.GetValue<bool>("SkipAzureConfig");
if (!skipAzureConfig)
{
    builder.Configuration.AddAzureAppConfiguration(options =>
    {
        // 你的Azure配置逻辑
    });
}

// 后续逻辑...

然后在测试的WebApplicationFactory中注入开关并添加测试配置：

public class TestWebApplicationFactory : WebApplicationFactory<Program>
{
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.ConfigureAppConfiguration((context, config) =>
        {
            // 添加内存配置，设置跳过Azure的开关为true
            config.AddInMemoryCollection(new Dictionary<string, string>
            {
                ["SkipAzureConfig"] = "true"
            });
            // 添加测试配置文件
            config.AddJsonFile("appsettings.test.json", optional: false, reloadOnChange: true);
        });
    }
}

这种方式更灵活，无需修改环境，通过配置参数直接控制Azure配置的加载逻辑。

方案优势对比 #

常规的configuration.Sources.Clear()方案是让程序先完整加载所有配置（包括连接Azure），再清空替换，这会导致：

• 不必要的Azure网络请求，拖慢测试速度
• CI环境中因无Azure凭据触发验证失败

而上面的两种方案是在Azure配置加载之前就阻止了执行逻辑，从根本上避免了这些问题，测试启动更快且不依赖Azure权限。

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