.NET 5 WorkerService中ASPNETCORE_ENVIRONMENT为Development时IsDevelopment()返回false问题

问题原因 #

这个问题是.NET通用主机和ASP.NET Core Web主机的环境变量读取规则差异导致的，具体原因如下：

1. 你当前使用的Host.CreateDefaultBuilder属于.NET通用主机构建器，默认优先读取DOTNET_ENVIRONMENT环境变量作为环境标识，ASPNETCORE_ENVIRONMENT是ASP.NET Core Web主机的专属默认读取变量，通用主机只有在未检测到DOTNET_ENVIRONMENT时才会尝试读取该值。
2. 若你已经配置了DOTNET_ENVIRONMENT仍不生效，大概率是以下两个原因：
   • 启动时选择的运行配置和你设置环境变量的配置不匹配，比如你在配置A里加了环境变量，但实际启动用的是配置B
   • 存在更高优先级的配置源覆盖了环境变量的值，比如命令行参数、appsettings.json中显式配置了环境值，或者系统全局环境变量里设置了优先级更高的生产环境配置

可行解决方案 #

方案1：使用通用主机默认的环境变量 #

直接在Debug属性的环境变量配置中，添加键为DOTNET_ENVIRONMENT，值为Development的配置即可，无需修改代码。

方案2：手动添加对ASPNETCORE_前缀环境变量的支持 #

如果你需要沿用ASPNETCORE_ENVIRONMENT的配置，可以在构建主机时显式添加对应前缀的环境变量读取：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        // 新增这段配置，优先读取ASPNETCORE_前缀的环境变量
        .ConfigureHostConfiguration(config =>
        {
            config.AddEnvironmentVariables(prefix: "ASPNETCORE_");
        })
        .ConfigureAppConfiguration((hostContext, builder) =>
        {
            if (hostContext.HostingEnvironment.IsDevelopment())
            {
                builder.AddUserSecrets<Program>();
            }
        })
        // 后续原有配置保持不变
        .ConfigureServices((hostContext, services) =>
        {
            // 原有服务注册逻辑
        });

方案3：校验launchSettings.json配置 #

打开项目Properties目录下的launchSettings.json文件，确认你当前使用的启动配置节点下已正确配置环境变量：

{
  "profiles": {
    "你的项目名称": {
      "commandName": "Project",
      "environmentVariables": {
        "DOTNET_ENVIRONMENT": "Development"
      }
    }
  }
}

方案4：排查配置源冲突 #

检查项目根目录下的appsettings.json、appsettings.*.json文件是否有显式的环境配置，同时确认启动时没有附加会覆盖环境变量的命令行参数。

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