.NET Core从环境变量获取数据库连接字符串失败求助

环境变量配置 #

我设置的环境变量如下：

"ASPNETCORE_ENVIRONMENT" : "Development"
"DatabaseConnectionString" : "SomeConnectionString"
"ConnectionStrings:DatabaseConnectionString" : "SomeConnectionString"
"ConnectionStrings__DatabaseConnectionString" : "SomeConnectionString"

代码尝试 #

在Program.cs中我做了以下尝试：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();
builder.Configuration.AddEnvironmentVariables();
var connString = builder.Configuration.GetConnectionString("DatabaseConnection");
var connString = builder.Configuration["DatabaseConnectionString"];
var connString = builder.Configuration["ConnectionStrings:DatabaseConnectionString"];
var connString = Environment.GetEnvironmentVariable("DatabaseConnectionString");
builder.Services.AddDbContext<DbContext>(options => options.UseSqlServer(connString));

异常现象 #

• 所有尝试获取的连接字符串结果都是null
• 将ASPNETCORE_ENVIRONMENT修改为"Staging"后，程序读取到的仍然是"Development"

我查阅过相关资料但问题未解决。

1. 环境变量的正确设置规则 #

不同系统对环境变量命名有要求，别踩格式坑：

• Windows系统：环境变量名不能用冒号(:)，必须用双下划线(__)代替层级分隔，比如要设置ConnectionStrings下的连接串，变量名得写成ConnectionStrings__DatabaseConnectionString，而非ConnectionStrings:DatabaseConnectionString
• Linux/macOS系统：环境变量名习惯全大写，层级同样用下划线分隔，比如CONNECTIONSTRINGS__DATABASECONNECTIONSTRING、ASPNETCORE_ENVIRONMENT
• 关键提醒：设置完环境变量后必须重启IDE/终端，不然新变量不会生效——这是绝大多数人踩的坑

2. 检查配置加载逻辑 #

WebApplication.CreateBuilder(args)默认已经自动加载了环境变量，不需要手动调用builder.Configuration.AddEnvironmentVariables()，重复调用可能打乱配置加载顺序。可以打印配置源确认加载顺序：

foreach (var source in builder.Configuration.Sources)
{
    Console.WriteLine(source.GetType().Name);
}

默认加载优先级是：命令行参数 > 环境变量 > 本地配置文件（appsettings.json等），确保环境变量没被后续配置源覆盖。

3. 正确获取连接字符串 #

• 使用GetConnectionString方法时，参数对应ConnectionStrings节点下的键名。如果你的环境变量是ConnectionStrings__DatabaseConnectionString，调用方式应为：

  var connString = builder.Configuration.GetConnectionString("DatabaseConnectionString");
  

• 直接通过索引取值时，要和环境变量名完全匹配：

  // 对应环境变量DatabaseConnectionString
  var connString = builder.Configuration["DatabaseConnectionString"];
  // 对应环境变量ConnectionStrings__DatabaseConnectionString
  var connString = builder.Configuration["ConnectionStrings:DatabaseConnectionString"];
  

4. 验证环境变量是否真的生效 #

在程序启动时打印所有环境变量，确认变量是否被正确加载：

// 打印所有环境变量
foreach (DictionaryEntry envVar in Environment.GetEnvironmentVariables())
{
    Console.WriteLine($"{envVar.Key}: {envVar.Value}");
}

如果看不到你设置的变量，说明环境变量没配置成功，或者没重启终端/IDE。

5. 排查本地配置文件覆盖问题 #

检查appsettings.json、appsettings.Development.json等配置文件，看是否定义了同名的ASPNETCORE_ENVIRONMENT或连接字符串——如果配置源顺序被修改，本地配置文件可能会覆盖环境变量。

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