服务端Blazor中HttpClient异步调用及依赖注入问题排查

问题核心分析 #

你遇到的直接问题是组件在异步操作完成前就开始渲染，导致Person为null时访问Person.Name报错，而深层原因大概率是自定义HttpClient调用时混用了同步阻塞代码，引发了死锁，让OnInitializedAsync里的异步调用无法正常完成（Fiddler看到请求返回但代码卡在await处）。

一、ASP.NET中自定义HttpClient的SendAsync注意事项 #

• 绝对禁止异步代码中混用同步阻塞：比如在async方法里用.Result、.Wait()等待异步操作，这会直接触发死锁。ASP.NET（包括Blazor Server）的SynchronizationContext会占用线程等待异步回调，同步阻塞会锁死上下文，导致请求返回后代码无法继续执行。
• 必须通过DI获取HttpClient：手动new HttpClient()会导致连接池耗尽、DNS缓存不更新等问题，DI提供的HttpClient由IHttpClientFactory管理，自动处理连接复用和生命周期。
• 正确管理Handler生命周期：自定义HttpClientHandler时，要确保Dispose逻辑正确，若注册为Scoped/Transient，避免资源泄漏。
• 传递CancellationToken：调用SendAsync时必须传入有效的取消令牌（比如Blazor组件自带的CancellationToken），防止组件销毁后请求仍在后台运行。
• 全程使用async/await：从发起请求到处理响应，全程保持异步，不要中途切换为同步调用。

二、Blazor Server异步编程最佳实践 #

1. ConfigureAwait(false)的使用 #

• Blazor组件生命周期方法中不要用：组件生命周期方法（如OnInitializedAsync）依赖SynchronizationContext更新UI、访问组件状态，用ConfigureAwait(false)会脱离上下文，导致后续UI更新报错。
• 纯业务服务类中可以用：在不依赖Blazor上下文的后台服务、逻辑层方法中，用ConfigureAwait(false)可以避免不必要的上下文切换，提升性能。

2. 处理异步渲染的null状态 #

Blazor不会等待异步生命周期方法完全完成才渲染组件，会先渲染初始状态，等异步操作完成后再触发重渲染。所以必须提前处理Person为null的情况：

@if (Person != null)
{
    <PageTitle>@Person.Name</PageTitle>
    <!-- 其他依赖Person的内容 -->
}
else
{
    <PageTitle>加载中...</PageTitle>
    <p>正在获取人员信息...</p>
}

3. 服务注册的最佳实践 #

• 优先用Scoped：Blazor Server中每个用户连接对应一个Scoped上下文，Scoped服务的生命周期和用户会话一致，是默认推荐的注册范围。
• 无状态服务用Singleton：比如纯逻辑处理的GetPersonHandler，如果是线程安全的，注册为Singleton可以减少对象创建开销。
• Transient仅在必要时使用：频繁创建销毁Transient服务会增加性能开销，除非服务有状态且不能共享。

4. HttpClient的正确用法 #

在Program.cs中注册HttpClient：

builder.Services.AddHttpClient();

然后在组件或服务中通过构造函数注入：

public class GetPersonHandler
{
    private readonly HttpClient _httpClient;

    public GetPersonHandler(HttpClient httpClient)
    {
        _httpClient = httpClient;
    }
}

三、你的代码修复示例 #

修改后的组件代码 #

@page "/person/{personId:int}/{viewMode}"
@using Laz.Core.Blazor.Components
@using Laz.Project.Core.Domain.Models
@using Laz.Core.Domain.Handlers
@inject GetPersonHandler GetPersonHandler
@inject ILogger<PrintPerson> Logger

@if (Person != null)
{
    <PageTitle>@Person.Name</PageTitle>
    <!-- 这里放依赖Person的UI内容 -->
}
else
{
    <PageTitle>加载中...</PageTitle>
    <div>正在加载人员数据，请稍候...</div>
}

@code {
    [Parameter]
    public int PersonId { get; set; } = 0;

    [Parameter]
    public string ViewMode { get; set; }

    public ApiPerson Person { get; set; } = null;

    protected override async Task OnInitializedAsync()
    {
        Logger.LogInformation("OnInitializedAsync - Person Page");
        var req = new GetPersonRequest { PersonId = PersonId };
        Logger.LogInformation("1");
        
        // 使用组件自带的CancellationToken，组件销毁时自动取消请求
        GetPersonResponse response = await GetPersonHandler.Handle(req, CancellationToken);
        Logger.LogInformation("2");
        Person = response.Person;
        Logger.LogInformation("3");
        
        await base.OnInitializedAsync();
    }
}

修复后的GetPersonHandler（异步化） #

public class GetPersonHandler
{
    private readonly HttpClient _httpClient;

    public GetPersonHandler(HttpClient httpClient)
    {
        _httpClient = httpClient;
    }

    public async Task<GetPersonResponse> Handle(GetPersonRequest request, CancellationToken cancellationToken)
    {
        // 获取令牌：全程用async/await，不要用.Result
        var tokenRequest = new HttpRequestMessage(HttpMethod.Post, "/api/token");
        var tokenResponse = await _httpClient.SendAsync(tokenRequest, cancellationToken);
        tokenResponse.EnsureSuccessStatusCode();
        var token = await tokenResponse.Content.ReadAsStringAsync(cancellationToken);

        // 获取人员信息
        var personRequest = new HttpRequestMessage(HttpMethod.Get, $"/api/person/{request.PersonId}");
        personRequest.Headers.Add("Authorization", $"Bearer {token}");
        var personResponse = await _httpClient.SendAsync(personRequest, cancellationToken);
        personResponse.EnsureSuccessStatusCode();
        var person = await personResponse.Content.ReadFromJsonAsync<ApiPerson>(cancellationToken);

        return new GetPersonResponse { Person = person };
    }
}

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