Blazor Server中添加自定义Claim后无法显示的原因排查

核心原因 #

1. 未持久化修改后的认证票据：在OnTokenValidated事件中修改Principal后，没有更新对应的AuthenticationTicket，后续认证流程仍会使用原始票据数据，新增的Claim和Identity不会被保留。
2. 新增Identity未标记为已认证：如果创建ClaimsIdentity时未指定认证类型，其IsAuthenticated属性默认是false，ClaimsPrincipal后续会自动忽略这类未认证的Identity，导致你添加的内容“消失”。
3. 服务实例化方式不当：直接通过new AuthService()创建服务，而非依赖注入获取，可能导致服务无法正确关联认证上下文（非核心问题，但会引发潜在隐患）。

修正方案 #

1. 直接修改现有已认证Identity（推荐）

无需新增Identity，直接在当前已认证的Identity中添加Claim，避免IsAuthenticated的问题：

// 在AuthService的EnrichClaims方法中
var identity = context.Principal.Identity as ClaimsIdentity;
if (identity != null)
{
    identity.AddClaim(new Claim(ClaimTypes.Sid, "44"));
}

2. 持久化修改后的Principal到认证票据

在OnTokenValidated事件中，修改完Principal后必须更新AuthenticationTicket，确保修改被保存：

builder.Services.Configure<MicrosoftIdentityOptions>(options =>
{
    options.Events = new OpenIdConnectEvents
    {
        OnTokenValidated = async (ctx) =>
        {
            // 通过依赖注入获取AuthService，避免直接new
            var authService = ctx.HttpContext.RequestServices.GetRequiredService<AuthService>();
            authService.EnrichClaims(ctx);

            // 更新认证票据，保存修改后的Principal
            ctx.Ticket = new AuthenticationTicket(
                ctx.Principal,
                ctx.Properties,
                ctx.Ticket.AuthenticationScheme);
        }
    };
});

3. 若必须新增Identity，需标记为已认证

如果业务场景需要新增Identity，必须指定认证类型，确保IsAuthenticated为true：

// 创建已认证的Identity
var identity = new ClaimsIdentity(
    new[] { new Claim(ClaimTypes.Sid, "44") }, 
    "CustomAuth" // 指定认证类型，确保IsAuthenticated为true
);
context.Principal.AddIdentity(identity);

4. Blazor Server中刷新认证状态

登录完成后，可通过AuthenticationStateProvider触发状态变更，确保组件能获取最新的Principal：

// 在组件中注入AuthenticationStateProvider
private readonly AuthenticationStateProvider _authStateProvider;

public YourComponent(AuthenticationStateProvider authStateProvider)
{
    _authStateProvider = authStateProvider;
}

// 登录完成后调用该方法
private async Task RefreshAuthState()
{
    await ((ServerAuthenticationStateProvider)_authStateProvider).RefreshAuthenticationStateAsync();
}

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