Blazor中封装API服务类的核心是抽离HTTP调用逻辑为可注入、可测试的强类型服务,配合IHttpClientFactory管理生命周期;需定义接口与实现类、返回Task、注入命名客户端、Scoped注册、组件中正确处理加载状态与异常。

Blazor 中封装 API 服务类,核心是把 HTTP 调用逻辑抽离成可复用、可注入、易测试的 C# 类,通常配合 IHttpClientFactory 使用,避免手动管理 HttpClient 生命周期问题。
创建强类型服务类
定义一个接口(如 IBlogService)和实现类(如 BlogService),把增删改查等操作封装为方法。返回类型推荐用 Task,适配 Blazor 的异步渲染流程。
- 接口定义清晰职责,方便 Mock 测试和依赖替换
- 实现类中不直接 new HttpClient,而是通过构造函数注入
IHttpClientFactory - 用
factory.CreateClient("Api")获取命名客户端,提前在Program.cs配置好基础地址和默认头
注册服务与命名客户端
在 Program.cs(或 Startup.cs)中注册服务,并配置命名 HttpClient:
builder.Services.AddHttpClient("Api", client => { client.BaseAddress = new Uri("https://api.example.com/"); }); - 也可额外添加拦截器,比如统一加 Authorization Header
- 服务生命周期建议用
AddScoped(组件级共享),避免跨用户状态污染
在组件中调用并处理状态
组件中通过 @inject IBlogService BlogService 使用,在 OnInitializedAsync 或事件中调用:
- 调用前设
IsLoading = true,触发 UI 更新(如显示 loading 指示器) - 用
try/catch捕获HttpRequestException,区分网络错误与业务错误 - 成功后赋值给
@bind或StateHasChanged()显式刷新(尤其在非 UI 线程回调时)
支持取消与错误重试(可选进阶)
对长请求或用户可能中断的场景,传入 CancellationToken:
- 方法签名改为
Task- > GetPostsAsync(CancellationToken ct)
- 调用时传
new CancellationTokenSource(TimeSpan.FromSeconds(10)).Token - 需要重试可用 Polly:在
AddHttpClient配置中加入.AddTransientHttpErrorPolicy(...)
基本上就这些。不复杂但容易忽略 HttpClient 生命周期和状态更新时机,按这个结构封装后,API 调用就干净、可控、可维护了。










