Blazor WebAssembly怎么调用API Blazor Wasm发起HTTP请求方法

星降 2025-12-21 00:00:00 次阅读

Blazor WebAssembly 调用 API 推荐使用注入的 IHttpClientFactory 和命名 HttpClient，支持配置、拦截与生命周期管理；需配置 CORS、手动处理 Token 认证、错误响应及加载状态。

Blazor WebAssembly 调用 API 主要靠 IHttpClientFactory 和 HttpClient，推荐用注入的客户端发请求，安全、可配置、支持拦截和生命周期管理。

在 Program.cs 中已默认注册了命名客户端（如 "ServerAPI"），你只需在组件中注入并调用：

确保 Program.cs 里有类似 builder.Services.AddScoped(sp => new HttpClient { BaseAddress = new Uri(builder.HostEnvironment.BaseAddress) }); 或更推荐的命名注册：builder.Services.AddHttpClient("ServerAPI", client => client.BaseAddress = new Uri(builder.HostEnvironment.BaseAddress));
组件中用 @inject IHttpClientFactory HttpClientFactory，然后 var client = HttpClientFactory.CreateClient("ServerAPI");
调用 await client.GetFromJsonAsync("api/values")，自动反序列化，简洁安全

提交数据常用 PostAsJsonAsync，后端接收需匹配模型结构：

定义请求体类，比如 public class LoginRequest { public string Username { get; set; } }
组件中： var response = await client.PostAsJsonAsync("api/auth/login", new LoginRequest { Username = "user" });
检查 response.IsSuccessStatusCode，再用 await response.Content.ReadFromJsonAsync() 解析结果
注意：WASM 运行在浏览器沙箱中，跨域需后端配 CORS，且不能绕过同源策略

真实场景中网络可能失败或延迟，别让 UI 卡住或静默出错：

用 try/catch 捕获 HttpRequestException，区分连接失败、404、500 等
配合 @if (isLoading) { Loading... } 显示加载态
对 401 响应可跳转登录页：if (response.StatusCode == HttpStatusCode.Unauthorized) Navigation.NavigateTo("/login");
避免在 OnInitializedAsync 中直接 await 长耗时请求，建议用 Task.Run 包裹或配合 StateHasChanged() 手动刷新

带身份凭证调用受保护接口很常见：

从本地存储读取 token：var token = await localStorage.GetItemAsStringAsync("auth_token");（需引用 Microsoft.AspNetCore.Components.Web.Extensions 或用 JS Interop）
设置头：client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
更优雅的做法是用 DelegatingHandler 封装自动加 token 逻辑，注册时链入：AddHttpClient(...).AddHttpMessageHandler();
注意：WASM 无法访问 Cookie（浏览器限制），Token 必须显式传，通常存在 localStorage 或 sessionStorage

基本上就这些。核心是用好 IHttpClientFactory + 异步方法 + 合理错误处理，不复杂但容易忽略加载态和跨域细节。