如何在IHostedService中将环境变量映射到配置对象？

我时隔许久首次创建控制台应用，正在学习使用IHostedService。目前已经能通过appsettings.json获取配置并注入到服务中，代码如下：

public static async Task Main(string[] args)
{
    await Host.CreateDefaultBuilder(args)
                .ConfigureServices((hostContext, services) =>
                {
                    services.AddHostedService<MyHostedService>();

                    services.Configure<MySettings>(hostContext.Configuration.GetSection("MySettings"));
                    services.AddSingleton<MySettings>(container =>
                    {
                        return container.GetService<IOptions<MySettings>>().Value;
                    });
                })
                .RunConsoleAsync();
}

public class MyHostedService
{
    public MyHostedService(MySettings settings)
    {
        // 这里可以访问MySettings的值
    }
}

public class MySettings
{
    public string ASetting { get; set; }
    public string AnotherSetting { get; set; }
}

// appsettings.json
{  
    "MySettings": {
        "ASetting": "a setting value",
        "AnotherSetting": "another value"
  }
}

现在我想改为从环境变量获取配置值，而非appsettings.json。我能看到环境变量在hostContext.Configuration中可用，也能通过Configuration.GetValue获取单个值，但需要把这些值映射到MySettings对象，再以依赖注入的方式传递给MyHostedService。

我尝试在Windows本地创建了双下划线格式的用户变量（比如MySettings_ASetting），但这些变量无法被读取，也无法覆盖appsettings.json中的值。想知道具体该怎么操作，比如是否有类似GetSection的等效方法，或者是否需要修改变量命名规则？

解决方案 #

1. 环境变量的正确命名规则（Windows系统） #

Windows环境变量不支持冒号（:）作为层级分隔符，必须用**双下划线（__）**替代。正确的变量命名应该是：

• 对应配置项MySettings:ASetting的环境变量：MySettings__ASetting（两个下划线）
• 对应配置项MySettings:AnotherSetting的环境变量：MySettings__AnotherSetting

你之前使用单下划线，这是配置系统无法识别的核心原因，改成双下划线即可。

2. 复用现有注入代码即可 #

Host.CreateDefaultBuilder默认已经包含环境变量配置源，且环境变量优先级高于appsettings.json（会自动覆盖配置文件中的值）。所以你现有的配置注入代码完全不需要修改：

services.Configure<MySettings>(hostContext.Configuration.GetSection("MySettings"));
services.AddSingleton<MySettings>(container =>
{
    return container.GetService<IOptions<MySettings>>().Value;
});

配置系统会自动将符合命名规则的环境变量映射到MySettings对象的对应属性中。

3. 验证环境变量生效 #

可以在MyHostedService中打印配置值验证：

public class MyHostedService : IHostedService
{
    private readonly MySettings _settings;

    public MyHostedService(MySettings settings)
    {
        _settings = settings;
        Console.WriteLine($"ASetting: {_settings.ASetting}");
        Console.WriteLine($"AnotherSetting: {_settings.AnotherSetting}");
    }

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

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

4. 可选：仅使用环境变量（忽略配置文件） #

如果想完全跳过appsettings.json，只从环境变量读取配置，可以在构建Host时清除默认配置源：

await Host.CreateDefaultBuilder(args)
    .ConfigureAppConfiguration((context, config) =>
    {
        // 清除默认配置源（包括appsettings.json、用户机密等）
        config.Sources.Clear();
        // 仅添加环境变量配置源
        config.AddEnvironmentVariables();
    })
    .ConfigureServices((hostContext, services) =>
    {
        services.AddHostedService<MyHostedService>();
        services.Configure<MySettings>(hostContext.Configuration.GetSection("MySettings"));
        services.AddSingleton<MySettings>(container =>
        {
            return container.GetService<IOptions<MySettings>>().Value;
        });
    })
    .RunConsoleAsync();

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