在AKS中使用ConfigMap与Azure App Configuration的C#配置读取问题

DevOps 小满

2026-7-16

问题

我们的应用将所有配置存储于Azure App Configuration并部署至AKS，目前仅用ConfigMap存储Azure App Configuration的端点。应用可读取该端点并成功连接到Azure App Configuration，但无法读取其中的配置值。当前配置加载代码如下：

builder.Host.ConfigureAppConfiguration(config =>
{
    if (Environment.GetEnvironmentVariable("DockerEnv") == "Docker")
    {
        config.SetBasePath(Directory.GetCurrentDirectory())
        // setting configmap
        .AddJsonFile("ConfigiurationFilePath", optional: false, reloadOnChange: true);
    }
});

 builder.Configuration.AddAzureAppConfiguration(option =>
    option.Connect(new Uri(ConfigEndpoint), new DefaultAzureCredential()));

应用通过IConfiguration读取配置时，ConfigMap中的值可正常返回，但Azure App Configuration中的值无法返回。请问是否需要采用不同方式读取不同配置，或是使用配置构建器同时读取两者？

解决方案

问题出在配置加载的顺序和方式上——你现在分开在Host.ConfigureAppConfiguration和直接操作builder.Configuration两个地方添加配置源，导致Azure App Configuration的配置没有被正确合并到应用的主配置体系中。

直接调整代码，把所有配置源统一放到Host.ConfigureAppConfiguration里配置：

builder.Host.ConfigureAppConfiguration((hostingContext, config) =>
{
    config.SetBasePath(Directory.GetCurrentDirectory());

    // 先加载ConfigMap挂载的JSON配置文件
    if (Environment.GetEnvironmentVariable("DockerEnv") == "Docker")
    {
        config.AddJsonFile("ConfigiurationFilePath", optional: false, reloadOnChange: true);
    }

    // 从已加载的配置中读取Azure App Configuration端点
    var configEndpoint = config["ConfigEndpoint"];
    if (!string.IsNullOrEmpty(configEndpoint))
    {
        // 添加Azure App Configuration作为配置源
        config.AddAzureAppConfiguration(options =>
        {
            options.Connect(new Uri(configEndpoint), new DefaultAzureCredential());
        });
    }
});

核心注意事项：

所有配置源必须通过ConfigureAppConfiguration方法添加，才能保证配置被正确合并到应用的IConfiguration中，避免分开操作导致的配置隔离。
先加载本地/ConfigMap的配置，再用读取到的端点连接Azure App Configuration，确保端点值能被正确获取。
不需要用不同方式读取不同配置，IConfiguration会自动合并所有配置源的内容，默认优先级是后添加的配置源覆盖先添加的（若存在重复键）。

额外排查点：

检查代码中ConfigiurationFilePath的拼写是否正确（当前代码里少了一个字母r，应为ConfigurationFilePath），以及路径是否匹配AKS中ConfigMap的实际挂载路径。
确认AKS环境下的DefaultAzureCredential拥有访问Azure App Configuration的权限，比如给AKS对应的服务主体分配App Configuration Data Reader角色。

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