Net8 Blazor Server：InteractiveServer模式下如何读取Cookie并持久化用户数据？

针对.NET 8 Blazor Server中InteractiveServer模式（带预渲染）下用户Cookie数据持久化问题，以下是可行方案：

方法1：利用PersistComponentState传递预渲染状态 #

这是官方推荐的预渲染与交互阶段状态传递方案，能避免数据丢失：

1. 在静态组件Routes.razor中读取Cookie并持久化状态：

@inject PersistComponentState ComponentState
@inject IHttpContextAccessor HttpContextAccessor

@{
    var userCookie = HttpContextAccessor.HttpContext?.Request.Cookies["你的用户Cookie名称"];
    if (!string.IsNullOrEmpty(userCookie))
    {
        var claims = ParseCookieToClaims(userCookie);
        var principal = new ClaimsPrincipal(new ClaimsIdentity(claims, "ExternalCookie"));
        // 将用户数据存入组件持久化状态
        ComponentState.PersistAsJson("UserPrincipal", principal);
    }
}

<Router AppAssembly="@typeof(App).Assembly">
    <!-- 保留原有Router内容 -->
</Router>

@code {
    private IEnumerable<Claim> ParseCookieToClaims(string cookieValue)
    {
        // 根据你的Cookie格式实现解析逻辑，示例为JSON反序列化
        var userData = JsonSerializer.Deserialize<UserData>(cookieValue);
        return new List<Claim>
        {
            new Claim(ClaimTypes.Name, userData.Username),
            new Claim(ClaimTypes.Role, userData.Role)
        };
    }

    private class UserData
    {
        public string Username { get; set; }
        public string Role { get; set; }
    }
}

2. 在交互式组件中恢复并使用状态：

@inject PersistComponentState ComponentState
@implements IComponentStatePersistence

<!-- 组件内容：网格、按钮等 -->

@code {
    private ClaimsPrincipal? _currentUser;

    protected override void OnInitialized()
    {
        // 从持久化状态恢复用户数据
        if (ComponentState.TryGetFromJson<ClaimsPrincipal>("UserPrincipal", out var principal))
        {
            _currentUser = principal;
        }
    }

    void IComponentStatePersistence.PersistState()
    {
        // 可选：组件重新渲染时再次持久化状态
        if (_currentUser != null)
        {
            ComponentState.PersistAsJson("UserPrincipal", _currentUser);
        }
    }
}

方法2：自定义AuthenticationStateProvider全局管理身份状态 #

若需要全局复用用户身份，可结合状态传递实现自定义身份提供者：

1. 实现自定义身份提供者：

public class CookieAuthStateProvider : AuthenticationStateProvider
{
    private ClaimsPrincipal? _cachedPrincipal;

    public void SetAuthState(ClaimsPrincipal principal)
    {
        _cachedPrincipal = principal;
        NotifyAuthenticationStateChanged(Task.FromResult(new AuthenticationState(principal)));
    }

    public override Task<AuthenticationState> GetAuthenticationStateAsync()
    {
        return _cachedPrincipal != null 
            ? Task.FromResult(new AuthenticationState(_cachedPrincipal)) 
            : Task.FromResult(new AuthenticationState(new ClaimsPrincipal(new ClaimsIdentity())));
    }
}

2. 在Program.cs注册服务：

builder.Services.AddScoped<CookieAuthStateProvider>();
builder.Services.AddScoped<AuthenticationStateProvider>(sp => sp.GetRequiredService<CookieAuthStateProvider>());
builder.Services.AddHttpContextAccessor();

3. 在Routes.razor中初始化身份状态并持久化：

@inject CookieAuthStateProvider AuthStateProvider
@inject PersistComponentState ComponentState
@inject IHttpContextAccessor HttpContextAccessor

@{
    var userCookie = HttpContextAccessor.HttpContext?.Request.Cookies["你的用户Cookie名称"];
    if (!string.IsNullOrEmpty(userCookie))
    {
        var claims = ParseCookieToClaims(userCookie);
        var principal = new ClaimsPrincipal(new ClaimsIdentity(claims, "ExternalCookie"));
        AuthStateProvider.SetAuthState(principal);
        ComponentState.PersistAsJson("AuthPrincipal", principal);
    }
}

<Router AppAssembly="@typeof(App).Assembly">
    <!-- 保留原有Router内容 -->
</Router>

@code {
    // 复用方法1中的ParseCookieToClaims逻辑
}

4. 在交互式组件中恢复全局身份状态：

@inject CookieAuthStateProvider AuthStateProvider
@inject PersistComponentState ComponentState

protected override void OnInitialized()
{
    if (ComponentState.TryGetFromJson<ClaimsPrincipal>("AuthPrincipal", out var principal))
    {
        AuthStateProvider.SetAuthState(principal);
    }
}

核心注意事项 #

• 预渲染阶段与InteractiveServer电路属于不同作用域实例，必须通过PersistComponentState显式传递数据，作用域服务无法自动共享状态。
• 禁止使用单例存储用户数据，会导致多用户数据冲突；作用域服务为每个用户连接（电路）创建独立实例，是正确选择。
• 保留预渲染才能保证网格正常加载，切勿关闭预渲染选项。
• InteractiveServer交互阶段无HttpContext，所有Cookie数据必须在预渲染阶段获取并传递。

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