Blazor 怎么封装一个 API 服务类

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 调用就干净、可控、可维护了。