.NET 6 Worker Service如何通过发布配置设置环境变量并加载对应配置

Worker Service 默认使用 DOTNET_ENVIRONMENT 环境变量（而非Web应用的 ASPNETCORE_ENVIRONMENT）来识别运行环境，这是你之前配置无效的核心原因。以下是几种可行的配置方案：

1. 确保配置加载逻辑正确（基础前提） #

.NET 6 的 Host.CreateDefaultBuilder 已经默认包含了环境对应配置文件的加载逻辑，会自动读取 appsettings.{EnvironmentName}.json。如果你的Worker没有加载对应文件，先检查：

• 确认 appsettings.{env}.json 的复制到输出目录属性设置为「如果较新则复制」或「始终复制」
• 确保环境变量值与配置文件名后缀完全匹配（比如 DOTNET_ENVIRONMENT=Dev 对应 appsettings.Dev.json）

如果需要自定义配置加载逻辑，可在 Program.cs 中显式扩展：

var host = Host.CreateDefaultBuilder(args)
    .ConfigureAppConfiguration((hostingContext, config) =>
    {
        var env = hostingContext.HostingEnvironment;
        // 显式加载对应环境配置，可选开启自动重载
        config.AddJsonFile(
            $"appsettings.{env.EnvironmentName}.json",
            optional: true,
            reloadOnChange: true
        );
    })
    .ConfigureServices(services =>
    {
        services.AddHostedService<Worker>();
    })
    .Build();

await host.RunAsync();

2. 通过发布配置文件（.pubxml）指定环境 #

在Worker的 .pubxml 文件中添加以下配置，自动设置发布后的环境变量：

<PropertyGroup>
  <!-- 指定目标环境名称 -->
  <EnvironmentName>Dev</EnvironmentName>
</PropertyGroup>

<Target Name="ConfigureEnvironmentVariable" AfterTargets="Publish">
  <!-- 针对IIS部署：修改web.config中的DOTNET_ENVIRONMENT变量 -->
  <XmlPoke 
    XmlInputPath="$(PublishDir)\web.config"
    Query="/configuration/system.webServer/aspNetCore/environmentVariables/add[@name='DOTNET_ENVIRONMENT']/@value"
    Value="$(EnvironmentName)" />

  <!-- 针对自托管部署：生成环境变量设置脚本 -->
  <WriteLinesToFile 
    File="$(PublishDir)\set-env.bat"
    Lines="set DOTNET_ENVIRONMENT=$(EnvironmentName)"
    Overwrite="true"
    Encoding="utf-8" />
</Target>

发布后，IIS部署的web.config会自动注入环境变量；自托管场景可先执行 set-env.bat 再启动服务。

3. 命令行发布与运行时指定环境 #

发布时传递环境参数 #

dotnet publish -c Release -o ./publish /p:EnvironmentName=Staging

运行时指定环境变量 #

• Windows命令行：

set DOTNET_ENVIRONMENT=Staging && .\YourWorkerService.exe

• Linux/macOS终端：

DOTNET_ENVIRONMENT=Staging ./YourWorkerService

4. 开发环境调试配置 #

在 launchSettings.json 中添加调试配置，快速切换开发环境：

{
  "profiles": {
    "WorkerService_Dev": {
      "commandName": "Project",
      "environmentVariables": {
        "DOTNET_ENVIRONMENT": "Development"
      }
    },
    "WorkerService_QA": {
      "commandName": "Project",
      "environmentVariables": {
        "DOTNET_ENVIRONMENT": "QA"
      }
    }
  }
}

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