ASP.NET Core：launchSettings环境变量在EF迁移时无法读取的问题

问题根源 #

EF Core的工具命令（比如Add-Migration）不会自动加载launchSettings.json里定义的环境变量：

• 项目运行时，IIS Express或自托管进程会通过launchSettings的配置注入环境变量，所以Environment.GetEnvironmentVariable能正常读取；
• 但EF工具是直接启动你的项目程序集来获取DbContext配置，不走项目的常规启动流程，因此不会加载launchSettings中的环境变量，只会读取当前终端的环境变量或ASP.NET Core默认配置源（如appsettings.json、用户机密）中的内容。

解决方案 #

方案1：改用ASP.NET Core配置系统读取（推荐） #

放弃直接调用Environment.GetEnvironmentVariable，改用框架自带的IConfiguration读取配置，这样项目运行和EF工具执行时都能正确加载配置，同时适配Azure App Service的配置管理。

修改Program.cs：

var builder = WebApplication.CreateBuilder(args);

// 从配置系统读取，自动适配appsettings、环境变量、用户机密、Azure配置等
var dbConnection = builder.Configuration.GetConnectionString("DB_CONNECTION") 
                   ?? builder.Configuration["DB_CONNECTION"];

builder.Services.AddDbContext<ApplicationDbContext>(options =>
{
    options.UseSqlServer(dbConnection);
});

配置存储方式：

• 开发环境：将连接字符串存入appsettings.Development.json或用用户机密（Secret Manager）（避免硬编码到代码仓库）：

  {
    "DB_CONNECTION": "<你的开发环境连接字符串>"
  }
  

• Azure部署：直接在Azure门户的「配置」->「应用程序设置」中添加DB_CONNECTION，ASP.NET Core配置系统会自动读取这些环境变量，无需修改代码。

方案2：执行迁移时指定启动配置 #

如果坚持使用launchSettings里的环境变量，可在执行EF命令时通过--launch-profile参数指定要加载的配置节点：

dotnet ef migrations add <migration-name> --launch-profile AppProfile

（注意：AppProfile要与launchSettings.json中的配置节点名称完全一致）

这个命令会让EF工具加载指定启动配置中的环境变量，从而读取到DB_CONNECTION。

方案3：为EF工具单独配置环境变量（不推荐） #

你之前在NuGet控制台手动设置环境变量的方法可行，但不够优雅。也可以在项目文件中添加配置，让EF工具启动时自动加载：

<PropertyGroup>
  <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="6.0.0" />
</PropertyGroup>
<ItemGroup>
  <EnvironmentVariable Include="DB_CONNECTION" Value="<你的连接字符串>" />
</ItemGroup>

但此方法会将连接字符串硬编码到项目文件，不利于团队协作和安全，因此不推荐。

总结 #

优先选择方案1，ASP.NET Core配置系统原生支持多环境配置统一管理，完美适配你们团队用Azure App Service管理连接字符串的场景，无需针对EF工具做特殊处理，也能避免硬编码风险。

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