.NET：如何将JWT中逗号分隔的角色字符串解析为数组？

你的问题核心是默认JWT认证逻辑会将role字段的字符串值当作单个角色，而非数组，导致[Authorize(Role = "1")]无法匹配到对应角色。可以通过配置AddJwtBearer的事件处理器来手动解析逗号分隔的角色字符串，转换成角色数组。

具体配置代码 #

在ConfigureServices方法中配置JWT认证时，添加OnTokenValidated事件处理逻辑：

services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(options =>
    {
        // 基础Token验证配置（按需调整）
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = true,
            ValidateAudience = true,
            ValidateLifetime = true,
            ValidIssuer = Configuration["Jwt:Issuer"],
            ValidAudience = Configuration["Jwt:Audience"],
            IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(Configuration["Jwt:SecretKey"]))
        };

        // 处理Token验证后的角色解析
        options.Events = new JwtBearerEvents
        {
            OnTokenValidated = context =>
            {
                var roleClaim = context.Principal.Claims.FirstOrDefault(c => c.Type == "role");
                if (roleClaim != null && !string.IsNullOrWhiteSpace(roleClaim.Value))
                {
                    // 分割逗号分隔的角色字符串
                    var roles = roleClaim.Value.Split(',', StringSplitOptions.RemoveEmptyEntries);
                    var identity = context.Principal.Identity as ClaimsIdentity;
                    
                    if (identity != null)
                    {
                        // 移除原单个role声明
                        identity.RemoveClaim(roleClaim);
                        // 添加每个角色为独立的Role类型声明
                        foreach (var role in roles)
                        {
                            identity.AddClaim(new Claim(ClaimTypes.Role, role.Trim()));
                        }
                    }
                }
                return Task.CompletedTask;
            }
        };
    });

逻辑说明 #

1. 在Token验证通过后，从当前ClaimsPrincipal中取出role字段的字符串值；
2. 按逗号分割字符串得到角色数组，过滤掉空值；
3. 移除原有的单个role声明，将每个角色作为独立的ClaimTypes.Role类型声明添加到身份信息中；
4. 配置完成后，[Authorize(Role = "1")]就能正确识别JWT中的角色，正常完成授权验证。

内容的提问来源于stack exchange，提问作者Estevão Dias