.NET8 Blazor WebApp：SSR登录场景下用户数据持久化方案问询

我的应用全局采用无预渲染的InteractiveServerRenderMode，但登录组件使用静态SSR以获取HttpContext进行Cookie认证。

App.razor中渲染模式配置代码 #

<HeadOutlet @rendermode="RenderModeForPage" /> 
<Routes @rendermode="RenderModeForPage" />

@code {
    [CascadingParameter]
    private HttpContext HttpContext { get; set; } = default!;
    private IComponentRenderMode? RenderModeForPage => HttpContext.Request.Path.StartsWithSegments("/Account")
        ? null
        : new InteractiveServerRenderMode(false); 
}

登录组件（/Account/LogIn）的认证处理方法 #

public async Task HandleLogin()
{
    isLoading = true; // 显示加载状态
    await Task.Delay(2000);

    var results = await Authenticate(Input);
    if (results.User is not null)
    {
        var claims = new List<Claim>
            {
                new Claim(ClaimTypes.NameIdentifier, results.User.PersonId.ToString()),
                new Claim(ClaimTypes.Name, results.User.Login.UserName),
                new Claim(ClaimTypes.Email,results.User.Email),
            };

        var identity = new ClaimsIdentity(claims, CookieAuthenticationDefaults.AuthenticationScheme);
        var newUser = new ClaimsPrincipal(identity);

        var authProperties = new AuthenticationProperties()
        {
            AllowRefresh = true,
            ExpiresUtc = DateTime.UtcNow.AddMinutes(5),
            IsPersistent = Input.RememberMe,
        };

        // await ProtectedSessionStore.SetAsync("UserData", results); 此方法在静态SSR中不可用

        await Context.SignInAsync(CookieAuthenticationDefaults.AuthenticationScheme, newUser, authProperties);            
        RedirectManager.RedirectTo(ReturnUrl);
    }
    else
    {
        errorMessage = string.IsNullOrEmpty(results.Message) ? "Error: Invalid login credentials" : results.Message;
    }
}

由于ProtectedSessionStore在静态SSR中不可用，请问如何理想地持久化用户数据以供其他交互式组件访问？

针对静态SSR登录+全局交互式Server组件的场景，推荐以下几种实用方案：

1. 扩展Claims存储核心用户数据 #

既然已经基于Claims实现认证，可直接把核心用户数据追加为自定义Claim，比如代码里已有的PersonId、用户名、邮箱，若还有其他必要字段（如头像地址、角色），直接添加即可：

var claims = new List<Claim>
{
    new Claim(ClaimTypes.NameIdentifier, results.User.PersonId.ToString()),
    new Claim(ClaimTypes.Name, results.User.Login.UserName),
    new Claim(ClaimTypes.Email, results.User.Email),
    new Claim("AvatarUrl", results.User.AvatarUrl ?? string.Empty),
    new Claim("Role", results.User.Role)
};

后续交互式组件通过AuthenticationStateProvider获取用户Claims即可提取数据：

var authState = await AuthenticationStateProvider.GetAuthenticationStateAsync();
var user = authState.User;
var personId = user.FindFirstValue(ClaimTypes.NameIdentifier);
var avatarUrl = user.FindFirstValue("AvatarUrl");

这种方案最直接，依赖Cookie认证体系本身，适合存储核心、非敏感、体积小的数据。

2. 登录后在交互式组件中从API拉取完整数据 #

如果用户数据量较大，不适合存入Claims，可在登录跳转后的全局交互式组件（如MainLayout）中，调用后端API根据用户ID获取完整数据，再存入ProtectedSessionStore或全局状态容器：

// MainLayout.razor.cs
protected override async Task OnInitializedAsync()
{
    var authState = await AuthenticationStateProvider.GetAuthenticationStateAsync();
    var userId = authState.User.FindFirstValue(ClaimTypes.NameIdentifier);
    if (!string.IsNullOrEmpty(userId))
    {
        var userData = await UserApiClient.GetUserByIdAsync(Guid.Parse(userId));
        await ProtectedSessionStore.SetAsync("UserData", userData);
        // 也可存入全局状态管理库（如Blazor State）
    }
}

该方案避开SSR限制，能获取完整用户数据，适合数据量较大的场景。

3. 服务器端分布式缓存存储敏感数据 #

若需在服务器端持久化敏感数据，可使用IDistributedCache（如Redis、MemoryCache），登录时将数据存入缓存，Key用用户ID或SessionID：

// 登录时在SSR组件中写入缓存
await _distributedCache.SetStringAsync($"UserData_{results.User.PersonId}", 
    JsonSerializer.Serialize(results),
    new DistributedCacheEntryOptions
    {
        AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(30)
    });

交互式组件中通过用户ID读取缓存数据：

var userId = authState.User.FindFirstValue(ClaimTypes.NameIdentifier);
var userDataJson = await _distributedCache.GetStringAsync($"UserData_{userId}");
var userData = JsonSerializer.Deserialize<UserData>(userDataJson);

此方案避免数据暴露在客户端，但需配置分布式缓存，同时注意缓存过期与清理策略。

4. 利用AuthenticationProperties的Items存储小数据 #

如果数据量极小且非敏感，可将数据序列化后存入AuthenticationProperties的Items集合：

var authProperties = new AuthenticationProperties()
{
    AllowRefresh = true,
    ExpiresUtc = DateTime.UtcNow.AddMinutes(5),
    IsPersistent = Input.RememberMe,
    Items = { { "UserData", JsonSerializer.Serialize(results) } }
};

后续可通过HttpContext或AuthenticationStateProvider读取，但注意Cookie有4KB左右的大小限制，且数据会暴露在客户端。

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