Blazor注入NuGet包服务后页面加载失败问题求助

问题根源定位 #

你的核心问题是服务构造函数中同步调用异步方法引发的死锁：

• Blazor的DI容器在创建单例服务时运行在同步上下文环境中
• ApiConfigHelper的构造函数里如果直接调用了GetKeyVaultValue这类异步方法（且用.Result/.Wait()强制同步等待），会导致异步操作等待上下文释放，而同步线程又被异步操作阻塞，形成死锁
• 这也是为什么仅依赖IOptions的服务能正常工作，一旦引入依赖IApiHelper（间接依赖IApiConfigHelper的异步逻辑）就会卡死

解决方案 #

1. 重构异步逻辑，避免在构造函数中执行异步操作 #

给服务添加异步初始化方法，将原本在构造函数中的异步逻辑迁移过去：

// 定义带初始化方法的接口
public interface IApiConfigHelper
{
    Task InitializeAsync();
    // 保留原有业务方法
}

public class ApiConfigHelper : IApiConfigHelper
{
    private readonly SecretClient _secretClient;
    private string _apiKey;

    // 构造函数仅做同步依赖注入，不执行异步操作
    public ApiConfigHelper(SecretClient secretClient)
    {
        _secretClient = secretClient;
    }

    // 异步初始化方法，处理密钥获取、HttpClient配置等逻辑
    public async Task InitializeAsync()
    {
        var secret = await GetKeyVaultValue("ApiKey");
        _apiKey = secret.Value;
        // 这里完成HttpClient的配置等异步逻辑
    }

    private async Task<KeyVaultSecret> GetKeyVaultValue(string secretName = "")
    {
        try
        {
            if (_secretClient is not null)
            {
                var result = await _secretClient.GetSecretAsync(secretName);
                return result.Value; 
            }
        }
        catch (ArgumentException ae)
        {
            Console.WriteLine(ae.Message);
        }
        catch (Azure.RequestFailedException rfe)
        {
            Console.WriteLine(rfe.Message);
        }

        return new(secretName, "");
    }
}

2. 在应用启动时异步初始化单例服务 #

在Program.cs中，构建应用后手动触发异步初始化：

var builder = WebApplication.CreateBuilder(args);

// 注册SecretClient及其他服务
builder.Services.AddSingleton<SecretClient>(sp =>
{
    var vaultUri = new Uri(builder.Configuration["KeyVault:Uri"]);
    return new SecretClient(vaultUri, new DefaultAzureCredential());
});
builder.Services.AddSingleton<IApiConfigHelper, ApiConfigHelper>();
builder.Services.AddSingleton<IApiHelper, ApiHelper>();
builder.Services.AddSingleton<ISystemEndpoint, SystemEndpoint>();

// 构建应用
var app = builder.Build();

// 异步初始化服务
using var scope = app.Services.CreateScope();
var apiConfigHelper = scope.ServiceProvider.GetRequiredService<IApiConfigHelper>();
await apiConfigHelper.InitializeAsync();

// 配置中间件（确保UseCors在UseRouting之后）
app.UseCors("OpenCorsPolicy");
app.UseRouting();
// 其他中间件配置...

app.Run();

3. 验证CORS配置（非核心问题，但需确认） #

你的NuGet包是在服务器端调用外部服务，浏览器CORS规则不影响服务器端的HTTP请求，所以之前的CORS配置不是导致页面卡死的原因。但仍需确保中间件顺序正确：UseCors必须放在UseRouting之后、UseAuthorization之前（如果使用授权）。

替代方案：使用后台服务预加载异步资源 #

如果希望初始化逻辑自动运行，可以创建IHostedService实现：

public class KeyVaultInitializer : IHostedService
{
    private readonly IApiConfigHelper _apiConfigHelper;

    public KeyVaultInitializer(IApiConfigHelper apiConfigHelper)
    {
        _apiConfigHelper = apiConfigHelper;
    }

    public async Task StartAsync(CancellationToken cancellationToken)
    {
        await _apiConfigHelper.InitializeAsync();
    }

    public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
}

然后注册该服务：

builder.Services.AddHostedService<KeyVaultInitializer>();

总结 #

页面卡死的本质是同步上下文与异步操作的死锁，通过将异步逻辑从构造函数迁移到专门的初始化方法，并在应用启动时异步执行，即可解决问题。

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