切换launchSettings.json配置及ASPNETCORE_ENVIRONMENT为Staging时Asp.Net Core 6 Web API遇CORS错误

问题核心 #

你遇到的问题本质是非Development环境下，Web API无法正确读取到允许跨域的源地址，导致CORS策略失效。

原因分析 #

你的CORS配置依赖builder.Configuration["SPAUrl"]获取允许的源，但.NET会根据ASPNETCORE_ENVIRONMENT变量自动加载对应环境的配置文件：

• 当环境为Development时，会加载appsettings.Development.json，这个文件里应该已经配置了SPAUrl值；
• 切换到Staging或Production时，程序会尝试读取appsettings.Staging.json或appsettings.Production.json，如果这两个文件不存在或没有配置SPAUrl，就会导致WithOrigins拿到空值，CORS策略直接失效，触发跨域错误。

解决方案 #

1. 补充对应环境的配置文件

确保项目中存在appsettings.Staging.json和appsettings.Production.json文件，并在其中添加SPAUrl配置：

{
  "SPAUrl": "http://localhost:4200"
}

2. 临时验证方案（快速定位问题）

如果想快速确认是配置读取问题，可以临时修改CORS策略，硬编码允许的源：

builder.Services.AddCors(options =>
{
    options.AddDefaultPolicy(
        b =>
        {
            b.WithOrigins("http://localhost:4200").AllowAnyMethod().AllowAnyHeader();
        });
});

运行Staging/Production环境，如果此时CORS错误消失，就说明确实是配置文件缺失的问题。

3. 验证配置加载情况

可以在Program.cs中添加一行日志，确认SPAUrl的值是否正确读取：

// 在AddCors之前添加
Console.WriteLine($"当前环境: {builder.Environment.EnvironmentName}, SPAUrl: {builder.Configuration["SPAUrl"]}");

启动对应环境后，查看控制台输出，如果SPAUrl为空，就说明配置文件没加载对或者没配置该项。

4. 检查配置加载顺序（可选）

.NET默认配置加载优先级为：appsettings.json → appsettings.{Environment}.json → 环境变量 → 命令行参数。如果appsettings.json中也配置了SPAUrl，可以确保所有环境都能读取到，但建议还是在对应环境的配置文件中单独设置，方便后续部署时修改。

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