容器中如何用环境变量覆盖ASP.NET Core带点的appsettings键名

方法一：利用.NET默认规则（推荐） #

.NET 6的环境变量配置提供器默认支持用**双下划线__**替代配置键中的点.，Linux容器允许使用双下划线作为环境变量名称的一部分。

比如你要覆盖one.special.key这个配置键，只需在容器中设置环境变量：

one__special__key="new value"

启动应用后，配置系统会自动将这个环境变量解析为one.special.key，第三方库就能正常读取到覆盖后的值。

逻辑说明：.NET配置系统中，环境变量的双下划线会被当作配置路径的分隔符，和配置文件中的点、冒号等价，这种方式完全适配第三方库的读取需求，无需修改任何代码。

方法二：自定义环境变量键映射规则 #

如果因特殊需求需要自定义键的转换逻辑（比如想用单下划线代替点），可以通过扩展EnvironmentVariableConfigurationSource实现：

1. 在Program.cs中添加自定义配置提供器逻辑：

var builder = WebApplication.CreateBuilder(args);

// 自定义环境变量配置源
var envSource = new EnvironmentVariableConfigurationSource
{
    Prefix = "",
    EnvironmentVariableNameComparer = StringComparer.OrdinalIgnoreCase,
    Load = () =>
    {
        var variables = Environment.GetEnvironmentVariables();
        var data = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);

        foreach (DictionaryEntry variable in variables)
        {
            var key = variable.Key.ToString();
            // 将单下划线替换为点
            var configKey = key.Replace("_", ".");
            data[configKey] = variable.Value.ToString();
        }

        return data;
    }
};

builder.Configuration.Add(envSource);

// 后续应用构建逻辑
var app = builder.Build();
// ...

2. 此时在容器中设置环境变量one_special_key="new value"，配置系统会自动将其转换为one.special.key，供第三方库读取。

注意：这种方式会覆盖默认的环境变量解析逻辑，需确保不会影响其他配置项的读取。

方法三：使用配置文件挂载（备选） #

如果不想通过环境变量传递，也可以在容器中将包含带点配置键的自定义配置文件（比如appsettings.override.json）挂载到应用目录，让.NET优先读取该文件的配置：

1. 创建自定义配置文件appsettings.override.json：

{
    "one.special.key": "new value from mounted file"
}

2. 在容器启动命令中添加挂载参数（以Docker为例）：

docker run -v /host/path/to/appsettings.override.json:/app/appsettings.override.json your-app-image

3. .NET会自动加载同目录下的appsettings.override.json，并覆盖appsettings.json中的对应配置，优先级高于默认的appsettings.json。

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