IdentityServer4 MVC客户端User.Identity.Name返回空问题解决咨询

你遇到的User.Identity.Name取值为空，本质是Claims的类型匹配规则不对应导致的：

• .NET 认证框架默认读取User.Identity.Name时，会查找Claims列表中类型为ClaimTypes.Name（对应固定URI为http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name）的claim值
• 你通过OIDC从IdentityServer拉取的用户Claims里，存储用户名的字段一般是name或preferred_username，和框架默认匹配的claim类型完全不一致，自然读不出值——这也是为什么你直接遍历Claims列表能拿到用户名，但直接读User.Identity.Name是空的原因。

方案1：在OIDC配置中指定NameClaimType映射（推荐，改动最小） #

直接在MVC客户端已有的AddOpenIdConnect配置块中新增Token校验参数的映射规则，不需要改动其他现有代码：

.AddOpenIdConnect("oidc",options=> {
    // 你原有的OIDC配置保持不变，包括Authority、ClientId、Scope等
    // ...

    // 新增以下配置
    options.TokenValidationParameters = new Microsoft.IdentityModel.Tokens.TokenValidationParameters
    {
        // 告诉框架：读取"name"类型的claim作为Identity.Name的来源
        // 如果你的用户名存在"preferred_username" claim里，就替换为对应字段名
        NameClaimType = "name",
        // 顺带可以提前配置角色claim的映射，避免后续取角色值时再出现同样问题
        RoleClaimType = "role"
    };
})

这个配置会同时作用于ID Token、UserInfo接口返回的Claims，配置完成后走完正常登录流程，就可以直接通过User.Identity.Name取到对应用户名，不需要额外写自定义转换逻辑。

方案2：通过Token校验事件做自定义Claims转换 #

如果你不想修改全局Token校验参数的默认配置，也可以在OIDC的OnTokenValidated事件里，手动把用户名映射为框架默认识别的Name类型：

.AddOpenIdConnect("oidc",options=> {
    // 你原有的OIDC配置保持不变
    // ...

    // 新增事件处理逻辑
    options.Events.OnTokenValidated = context =>
    {
        // 从已拿到的Claims中取出用户名值
        var username = context.Principal.FindFirst("name")?.Value;
        if (!string.IsNullOrEmpty(username))
        {
            var identity = context.Principal.Identity as ClaimsIdentity;
            // 手动给身份对象添加框架默认识别的Name类型Claim
            identity.AddClaim(new Claim(ClaimTypes.Name, username));
        }
        return Task.CompletedTask;
    };
})

实际开发中容易踩的坑：
不少开发者会尝试在AddCookie的配置里添加Claims转换逻辑，这是无效的——OIDC流程的ClaimsIdentity是在Token校验阶段就完成构建的，如果在Token校验环节没有指定正确的NameClaimType，后续写入认证Cookie时携带的Claims本身就不包含框架能识别的Name类型字段，在Cookie层做修改不会生效。

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