ASP.NET Core 7中如何从launchSettings.json读取默认环境变量？

核心原因 #

直接使用Environment.GetEnvironmentVariable("HOST_URL")返回null，通常有两个关键原因：

1. 启动方式不匹配：launchSettings.json中的环境变量仅在通过对应profile启动时才会注入进程环境（比如Visual Studio选择http profile，或使用dotnet run --launch-profile http命令）。如果直接运行编译后的exe，或使用了其他未配置该变量的profile，这些变量不会被加载。
2. 读取时机/方式错误：Environment.GetEnvironmentVariable读取的是进程启动时的环境变量，而launchSettings的环境变量是由ASP.NET Core启动框架在初始化阶段注入的，如果在WebApplication.CreateBuilder之前调用该方法，可能还未完成变量注入。

正确解决方案 #

ASP.NET Core推荐使用IConfiguration读取配置，它会自动处理多配置源的优先级（系统环境变量 > launchSettings.json环境变量），刚好满足你"系统变量存在则用系统值，否则用launchSettings默认值"的需求。

1. 在Program.cs中直接读取 #

var builder = WebApplication.CreateBuilder(args);

// 读取HOST_URL：系统环境变量优先，其次是launchSettings中的值
var hostUrl = builder.Configuration["HOST_URL"];

// 可选：如果需要兜底默认值（连launchSettings都没配置时用）
// var hostUrl = builder.Configuration["HOST_URL"] ?? "http://localhost:8080";

// 后续构建应用...
var app = builder.Build();

2. 在服务/控制器中注入读取 #

如果需要在其他类中读取，通过依赖注入IConfiguration：

[ApiController]
[Route("api/[controller]")]
public class TestController : ControllerBase
{
    private readonly IConfiguration _configuration;

    public TestController(IConfiguration configuration)
    {
        _configuration = configuration;
    }

    [HttpGet]
    public IActionResult GetHostUrl()
    {
        var hostUrl = _configuration["HOST_URL"];
        return Ok(hostUrl);
    }
}

验证启动方式 #

确保你使用正确的profile启动项目：

• Visual Studio：在顶部启动配置下拉菜单中选择http profile（对应你launchSettings中的配置项）。
• 命令行：在项目根目录执行dotnet run --launch-profile http。

你可以临时添加代码验证环境变量是否被注入：

// 在WebApplication.CreateBuilder之后添加
foreach (DictionaryEntry envVar in Environment.GetEnvironmentVariables())
{
    Console.WriteLine($"{envVar.Key}: {envVar.Value}");
}

启动后查看控制台输出，确认HOST_URL是否存在。

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