.NET Core应用无法通过环境变量加载正确的appsettings配置

我有一个基于.NET Core的简单应用，使用WebApplicationBuilder创建实例。本地运行时（使用MyApp.Api配置）能正常加载appsettings.Development.json并覆盖appsettings.json的配置，但部署到外部服务器后，无法加载指定的appsettings.CURRENT.json。

服务器已设置环境变量：

Environment=ASPNETCORE_ENVIRONMENT=CURRENT
Environment=DOTNET_ENVIRONMENT=CURRENT

且确认配置文件已部署到正确目录：

-rw-r--r--  1 root root    2397 Oct 13  2022 appsettings.CURRENT.json
-rw-r--r--  1 root root    1527 Oct 13  2022 appsettings.json

Program.cs核心代码：

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.

var logger = new LoggerConfiguration()
    .ReadFrom.Configuration(builder.Configuration)
    .Enrich.FromLogContext()
    .CreateLogger();

builder.WebHost.ConfigureLogging(logging =>
{
    logging.ClearProviders();
    logging.AddConsole();
    logging.AddSerilog(logger);
});

1. 修正环境变量设置格式 #

服务器上的环境变量写法错误，Environment=ASPNETCORE_ENVIRONMENT=CURRENT这种格式不符合Linux环境变量的设置规范，应直接设置变量名与对应值：

# 临时生效（当前会话）
export ASPNETCORE_ENVIRONMENT=CURRENT
export DOTNET_ENVIRONMENT=CURRENT

# 永久生效（写入运行用户的bash配置文件，如~/.bashrc）
echo 'export ASPNETCORE_ENVIRONMENT=CURRENT' >> ~/.bashrc
echo 'export DOTNET_ENVIRONMENT=CURRENT' >> ~/.bashrc
source ~/.bashrc

如果通过systemd管理应用服务，需在服务配置文件的[Service]段添加：

Environment="ASPNETCORE_ENVIRONMENT=CURRENT"
Environment="DOTNET_ENVIRONMENT=CURRENT"

2. 验证应用实际读取的环境名 #

在Program.cs中添加调试输出，确认应用是否正确识别当前环境：

var builder = WebApplication.CreateBuilder(args);

// 输出当前环境与加载的配置文件信息
Console.WriteLine($"当前环境：{builder.Environment.EnvironmentName}");
var configFiles = string.Join(", ", builder.Configuration.GetDebugView().Split('\n').Where(line => line.Contains(".json")));
Console.WriteLine($"已加载的配置文件：{configFiles}");

// 原有的Serilog初始化代码...

启动应用后查看控制台输出，确认环境名是否为CURRENT，以及是否包含appsettings.CURRENT.json的加载记录。

3. 显式指定配置文件加载逻辑 #

WebApplicationBuilder默认会自动加载对应环境的配置文件，但可显式声明加载逻辑确保优先级：

var builder = WebApplication.CreateBuilder(args);

builder.Configuration
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddJsonFile($"appsettings.{builder.Environment.EnvironmentName}.json", optional: true, reloadOnChange: true)
    .AddEnvironmentVariables();

// 原有的Serilog初始化代码...

4. 调整Serilog初始化时机 #

当前Serilog初始化过早，若环境变量未正确加载，会导致其无法读取appsettings.CURRENT.json的配置。改用UseSerilog扩展方法延迟初始化：

var builder = WebApplication.CreateBuilder(args);

// 替换原Serilog初始化代码
builder.Host.UseSerilog((context, config) =>
{
    config.ReadFrom.Configuration(context.Configuration)
          .Enrich.FromLogContext();
});

// 后续服务配置...

5. 检查文件读取权限 #

虽然配置文件存在，但应用运行用户可能没有读取权限。若应用以非root用户运行，需调整文件权限：

# 假设应用运行用户为www-data
chown www-data:www-data appsettings.CURRENT.json appsettings.json
chmod 644 appsettings.CURRENT.json appsettings.json

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