Blazor WASM托管部署IIS：BaseUri+相对API端点调用失败排查

变更背景 #

近期将API调用方式从完整URL硬编码改为BaseUri + 相对端点的组合模式，通过Azure DevOps经典发布管道部署到IIS后，出现API调用失败问题。令牌替换操作已确认成功，部署文件配置值正确，但运行时API返回404/500错误。

项目配置结构 #

当前项目包含Server和Client端两套配置文件：

Server端 #

• MyApp.Server/appsettings.Deploy.json：部署环境配置模板（用于令牌替换）
• MyApp.Server/appsettings.json：运行时加载的配置文件

Client端 #

• MyApp.Client/wwwroot/appsettings.Deploy.json：部署环境配置模板（用于令牌替换）
• MyApp.Client/wwwroot/appsettings.json：Blazor客户端运行时从wwwroot加载的配置文件

Azure DevOps发布管道步骤（经典模式） #

1. 解压构建压缩包至Extracted/目录
2. 对Server和Client端的appsettings.Deploy.json执行令牌替换
3. 通过PowerShell将替换后的appsettings.Deploy.json复制重命名为对应项目的appsettings.json
4. 重新打包并部署至IIS

注：令牌替换操作已验证成功，解压后的配置文件内容与预期一致。

客户端配置示例（替换后） #

MyApp.Client/wwwroot/appsettings.json内容：

{
  "AppBaseUri": "devmyapp.com/",
  "CreateAssessmentEndpoint": "api/assessment/assessment-create/{0}"
}

问题现象 #

• 客户端API调用返回404/500响应
• 服务器端日志报错：内部服务器错误：提供的请求URI无效。请求URI必须是绝对URI或已设置BaseAddress。

核心疑问 #

在令牌替换成功、配置文件内容正确的前提下，如何正确配置BaseUri+相对端点模式？具体需明确：

• AppBaseUri是否需要包含协议（如https://）和末尾斜杠？
• HttpClient.BaseAddress应该配置在Client端Program.cs、Server端还是两者都需要？
• Blazor客户端从wwwroot加载appsettings.json是否存在特殊限制，导致部署后文件存在但运行时未被读取？

问题解答 #

1. AppBaseUri的正确格式要求 #

必须包含完整协议前缀（https://或http://），且建议保留末尾斜杠（避免拼接URL时出现格式错误）。正确示例：

{
  "AppBaseUri": "https://devmyapp.com/",
  "CreateAssessmentEndpoint": "api/assessment/assessment-create/{0}"
}

如果缺少协议前缀，HttpClient无法识别为绝对URI，会触发"请求URI无效"的错误。

2. HttpClient.BaseAddress的配置位置 #

仅需在**Client端Program.cs**中配置，无需在Server端设置。配置方式如下：

// 从wwwroot加载appsettings.json
var configuration = new ConfigurationBuilder()
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .Build();

// 注册HttpClient并设置BaseAddress
builder.Services.AddScoped(sp => new HttpClient
{
    BaseAddress = new Uri(configuration["AppBaseUri"])
});

之后在组件或服务中注入HttpClient，直接使用相对端点发起请求即可：

// 示例：调用API
var response = await _httpClient.GetAsync(string.Format(configuration["CreateAssessmentEndpoint"], assessmentId));

3. wwwroot/appsettings.json的加载问题 #

Blazor WASM客户端默认会从wwwroot目录加载appsettings.json，但需注意以下几点：

• 确保appsettings.json的复制到输出目录属性设置为"始终复制"或"如果较新则复制"（在Visual Studio中右键文件→属性）
• 部署后可通过浏览器开发者工具的"网络"标签，检查appsettings.json是否被成功加载（状态码200）
• 如果启用了静态文件缓存，需确保浏览器没有缓存旧的配置文件（可强制刷新页面或配置IIS禁用静态文件缓存）

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