.NET Core 7 Web API部署时如何指定不同appsettings.json文件？

核心原因 #

.NET Core 应用通过ASPNETCORE_ENVIRONMENT环境变量识别运行环境，你执行dotnet publish -c QA仅指定了编译配置，但部署到IIS后，服务器未将环境变量设置为QA，导致应用默认 fallback 到Production环境加载对应配置。

具体解决步骤 #

1. 配置IIS站点的环境变量 #

• 打开IIS管理器，找到目标站点，右键选择「配置编辑器」
• 在「节」下拉菜单中选择system.webServer/aspNetCore
• 找到environmentVariables项，点击右侧「...」按钮
• 添加或修改名为ASPNETCORE_ENVIRONMENT的变量，值设为QA
• 保存配置后重启IIS站点

2. 确保QA配置文件被正确发布 #

检查项目文件（.csproj），确保QA配置文件被包含在发布内容中，若没有则添加以下配置：

<ItemGroup>
  <Content Include="appsettings.QA.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
  </Content>
</ItemGroup>

重新执行dotnet publish -c QA -o deploy，确认deploy目录下存在appsettings.QA.json文件。

3. 验证Program.cs的配置加载逻辑 #

确保Program.cs中按环境正确加载配置（默认模板已包含该逻辑，若有自定义需检查）：

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();

避免代码中硬编码指定Production环境。

4. 快速验证环境生效状态 #

可在API中添加一个测试接口，返回当前环境名称：

app.MapGet("/check-environment", (IWebHostEnvironment env) => env.EnvironmentName);

部署后访问该接口，确认返回值为QA而非Production。

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