如何按环境配置MVC前端API调用URL 避免手动切换与代码硬编码

核心思路是通过环境分层配置实现地址自动切换，同时把敏感配置从代码中抽离，避免提交到Git仓库。

1. .NET Core / .NET 5+ 版本MVC项目实现 #

该版本框架自带多环境配置体系，可直接使用：

• 项目根目录默认存在appsettings.json（公共配置，可提交到Git）和appsettings.Development.json（本地开发专用配置），在.gitignore中添加appsettings.Development.json规则即可避免本地配置被提交。更安全的可选方案是使用框架自带的「用户机密」功能，本地配置存储在系统用户目录下，完全不会进入项目目录，从根源避免误提交。
• 公共配置文件appsettings.json中只保留配置结构占位，不填实际敏感值：

{
  "ApiSettings": {
    "BaseAddress": ""
  }
}

• 本地开发时在appsettings.Development.json或者用户机密配置中填入本地API地址：

{
  "ApiSettings": {
    "BaseAddress": "https://localhost:44393/"
  }
}

• 生产环境的API地址不需要写在配置文件中，直接在Azure门户对应MVC应用服务的「配置」-「应用程序设置」里添加键为ApiSettings__BaseAddress、值为线上API地址的配置项即可，Azure环境变量的优先级高于本地配置文件，部署后会自动生效。
• 代码中读取配置使用，同时建议直接注册HttpClient到依赖注入容器，避免每次new HttpClient导致的套接字耗尽问题：
  首先定义配置映射类：

public class ApiSettings
{
    public string BaseAddress { get; set; }
}

在Program.cs中注册配置和HttpClient：

// 注册配置映射
builder.Services.Configure<ApiSettings>(builder.Configuration.GetSection("ApiSettings"));
// 注册带基地址的HttpClient
builder.Services.AddHttpClient("ApiClient", client =>
{
    var baseAddr = builder.Configuration.GetValue<string>("ApiSettings:BaseAddress");
    client.BaseAddress = new Uri(baseAddr);
});

业务代码中注入IHttpClientFactory使用即可：

public class YourService
{
    private readonly HttpClient _apiClient;
    public YourService(IHttpClientFactory httpClientFactory)
    {
        _apiClient = httpClientFactory.CreateClient("ApiClient");
    }
}

2. .NET Framework 版本MVC项目实现 #

使用Web.config配置转换功能实现：

• 在Web.config的appSettings节点添加配置占位：

<appSettings>
  <add key="ApiBaseAddress" value="" />
</appSettings>

• 本地开发用Web.Debug.config添加配置转换，填入本地API地址，将Web.Debug.config添加到.gitignore避免提交：

<appSettings>
  <add key="ApiBaseAddress" value="https://localhost:44393/" 
       xdt:Transform="SetAttributes" xdt:Locator="Match(key)"/>
</appSettings>

• 生产环境地址同样在Azure应用服务的应用设置中添加键为ApiBaseAddress的配置项即可，优先级高于Web.config中的配置，部署自动生效。
• 代码中读取配置：

string apiBaseAddr = ConfigurationManager.AppSettings["ApiBaseAddress"];
HttpClient client = new HttpClient { BaseAddress = new Uri(apiBaseAddr) };

额外优化建议 #

• 不要在业务代码中硬编码任何环境相关的配置项，所有敏感值统一通过配置源读取，从根源避免泄露风险。
• 如果有多环境部署需求，可以使用Azure的部署槽位功能，不同槽位分别配置对应环境的API地址，部署到对应槽位自动切换配置，无需修改任何代码。

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