.NET 8 Windows Service本地调试时宿主环境默认为Production的原因

我们有一个以Windows Service形式运行的.NET 8应用程序，遇到如下问题：在执行IHostBuilder.ConfigureAppConfiguration时，IHost.HostingEnvironment显示为Production。

看起来IHostBuilder默认将环境识别为Production，但项目中没有任何地方设置过该环境。

我已检查以下与ASPNETCORE_ENVIRONMENT相关的位置：

• launchsettings.json：已设置为Development
• 系统/用户环境变量：未设置ASPNETCORE_ENVIRONMENT，按默认逻辑应选择Development
• 整个项目：无任何位置将ASPNETCORE_ENVIRONMENT设置为Production

请问该问题的原因及解决方法是什么？

附Program.cs代码：

using LinqToDB.EntityFrameworkCore;
using PosJobs.LT.Server;
using PosJobs.LT.Server.Ioc;
using Sentry.Serilog;
using Serilog;
using Serilog.Events;
using Serilog.Formatting.Compact;

const long LogFileSizeLimit = 5 * 1024 * 1024;
var baseDirectory = AppContext.BaseDirectory;

IHost host = Host.CreateDefaultBuilder(args)
    .UseWindowsService(options =>
    {
        options.ServiceName = "PosJobs.LT";
    })
    .ConfigureAppConfiguration((ctx, builder) =>
    {
        var environment = ctx.HostingEnvironment.EnvironmentName;

        builder.SetBasePath(baseDirectory);
        builder.AddJsonFile("appsettings.json", false, true);
        builder.AddJsonFile($"appsettings.{environment}.json", true, true);
        builder.AddEnvironmentVariables();
    })
    .ConfigureServices((ctx, services) =>
    {
        var configuration = ctx.Configuration;

        services.ConfigureHangfire(ctx);
        services.ConfigureOptions(configuration);
        services.ConfigureServices(configuration);
        services.ConfigureDbContexts(configuration);
    })
    .UseSerilog((hostingContext, loggerConfiguration) =>
    {
        var f = new FileInfo(baseDirectory);
        var drive = Path.GetPathRoot(f.FullName);

        var logPath = @$"{drive}\Logs\PosJobs.LT\log_.json";

        loggerConfiguration
            .MinimumLevel.Information()
            .MinimumLevel.Override("Microsoft.EntityFrameworkCore", LogEventLevel.Error)
            .MinimumLevel.Override("Microsoft.AspNetCore.Hosting.Diagnostics", LogEventLevel.Error)
            .MinimumLevel.Override("Microsoft.AspNetCore.Routing.EndpointMiddleware", LogEventLevel.Error)
            .MinimumLevel.Override("Microsoft.AspNetCore.Authorization.DefaultAuthorizationService", LogEventLevel.Error)
            .MinimumLevel.Override("Microsoft.AspNetCore.Mvc.RazorPages.Infrastructure.PageActionInvoker",
                LogEventLevel.Error)
            .MinimumLevel.Override("Microsoft.AspNetCore.StaticFiles.StaticFileMiddleware", LogEventLevel.Error)
            .MinimumLevel.Override("Microsoft.AspNetCore", LogEventLevel.Error)
            .MinimumLevel.Override("Microsoft.AspNetCore.Mvc", LogEventLevel.Error)
            .WriteTo.Console()
            .WriteTo.File(new CompactJsonFormatter(),
                logPath,
                shared: true,
                restrictedToMinimumLevel: LogEventLevel.Information,
                retainedFileCountLimit: 90,
                rollingInterval: RollingInterval.Day,
                rollOnFileSizeLimit: true,
                fileSizeLimitBytes: LogFileSizeLimit);

        if (!hostingContext.HostingEnvironment.IsDevelopment())
        {
            loggerConfiguration.WriteTo.Sentry(options =>
            {
                var optionsToSet = hostingContext.Configuration.GetSection("SentrySerilog").Get<SentrySerilogOptions>();

                options.Dsn = optionsToSet.Dsn;
                options.Environment = optionsToSet.Environment;
                options.StackTraceMode = optionsToSet.StackTraceMode;
                options.MinimumEventLevel = optionsToSet.MinimumEventLevel;
                options.MinimumBreadcrumbLevel = optionsToSet.MinimumBreadcrumbLevel;
                options.InitializeSdk = true;
            });
        }
    })
    .Build();

IConfiguration config = host.Services.GetRequiredService<IConfiguration>();
config.RegisterJobs(host.Services);

LinqToDBForEFTools.Initialize();

await host.RunAsync();

更新#1 #

查阅资料后发现，通用IHost Builder检查的是DOTNET_前缀的环境变量，而非ASPNETCORE_前缀。在launchsettings.json中添加DOTNET_ENVIRONMENT变量后问题解决，但仍有疑问：为何通用IHost Builder默认将环境视为Production？

解答 #

问题原因

1. 环境变量前缀差异：ASP.NET Core Web应用默认读取ASPNETCORE_ENVIRONMENT，但通用IHost（非Web主机，比如Windows Service）默认读取DOTNET_ENVIRONMENT环境变量，二者为独立配置项。
2. 框架默认规则：根据.NET的设计，当未检测到DOTNET_ENVIRONMENT变量时，通用IHost会默认回退到Production环境。这是框架的内置安全设计，确保应用默认以最严格的生产模式运行，避免开发环境配置意外泄露到生产场景。

解决方法

除了在launchsettings.json中添加DOTNET_ENVIRONMENT=Development外，还有以下几种指定环境的方式：

• 命令行参数：启动服务时添加--environment Development参数
• 系统/用户环境变量：设置系统级或用户级的DOTNET_ENVIRONMENT变量为Development
• 代码显式指定：在Host.CreateDefaultBuilder后直接设置环境，示例代码：

Host.CreateDefaultBuilder(args)
    .UseEnvironment(Environments.Development)
    .UseWindowsService(...)

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