OpenIddict 3.1.1配置TokenValidationParameters映射NameClaimType到sub的方法

1. OpenIddict 3.1.1 将NameClaimType映射到sub声明的实现方案 #

你在源码中看到的是框架初始化时的默认赋值，并非不可修改，可通过服务配置直接覆盖，无需调整现有控制器业务逻辑，配置方式如下：
在服务注册阶段添加配置：

using OpenIddict.Abstractions;
using Microsoft.AspNetCore.Authentication.JwtBearer;

// 保留v2版本的声明映射清除逻辑，避免JWT中间件自动转换声明名
JwtSecurityTokenHandler.DefaultInboundClaimTypeMap.Clear();
JwtSecurityTokenHandler.DefaultOutboundClaimTypeMap.Clear();

// 覆盖OpenIddict验证的默认声明映射配置
services.Configure<OpenIddictValidationOptions>(options =>
{
    options.TokenValidationParameters.NameClaimType = OpenIddictConstants.Claims.Subject;
    options.TokenValidationParameters.RoleClaimType = OpenIddictConstants.Claims.Role;
});

配置完成后，User.Identity.Name将直接返回sub声明对应的用户ID，和v2版本行为完全一致。

2. 版本默认映射规则差异的原因 #

• OpenIddict 2.x版本的示例中推荐映射到sub，属于早期示例的自定义配置，并非框架默认规则，仅为满足特定场景需求给出的参考实现。
• OpenIddict 3.x版本对齐OpenID Connect核心规范的语义约定：sub的标准语义是用户唯一标识符，name的标准语义是用户可读的展示名称，.NET的Identity.Name属性常规语义对应展示用的用户名，因此框架默认将NameClaimType绑定到name声明，符合绝大多数业务场景的默认需求。

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