如何从配置文件初始化Blazor WASM客户端的HttpClient BaseAddress？

一、实现思路与核心步骤 #

1. 确保settings.json随WASM资源同步下载 #

• 将settings.json放在WASM项目的wwwroot目录下，.NET在部署时会自动将该文件与WASM运行时、DLL打包在一起，客户端加载应用时会同步下载此文件。
• 检查项目属性中该文件的“复制到输出目录”设置，需设为“始终复制”或“如果较新则复制”，防止部署遗漏。

2. 在Program.cs中读取配置并初始化HttpClient #

直接利用.NET内置的配置系统读取配置，完成HttpClient的BaseAddress设置：

var builder = WebAssemblyHostBuilder.CreateDefault(args);
builder.RootComponents.Add<App>("#app");

// 从settings.json读取服务器地址
var apiBaseAddress = builder.Configuration["ApiBaseAddress"];

// 注册并配置全局HttpClient
builder.Services.AddScoped(sp => new HttpClient
{
    BaseAddress = new Uri(apiBaseAddress ?? throw new InvalidOperationException("settings.json中未配置ApiBaseAddress"))
});

await builder.Build().RunAsync();

3. settings.json配置示例 #

在wwwroot/settings.json中添加对应配置项：

{
  "ApiBaseAddress": "https://your-deployed-server-url.com/api/"
}

二、关键注意事项 #

• 由于配置文件在客户端可见，禁止在settings.json中存放敏感信息（如密钥、凭证等）。
• 若需区分环境（开发/测试/生产），可创建多个配置文件（如settings.Development.json、settings.Production.json），部署时替换对应文件即可。
• 确保代码中读取的配置项名称与settings.json中的键名完全一致，避免出现读取失败的情况。

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