Blazor [Authorize]特性无法识别角色问题求助

问题分析 #

当前遇到的核心问题：标注[Authorize(Roles = "System Admin, Service")]的组件返回403 Forbidden，但用户实际拥有"System Admin"角色，且另一仅需认证的组件能正常列出包含该角色的所有声明。问题根源大概率是角色声明类型与ASP.NET Core授权系统的默认预期不匹配，或中间件配置顺序有误。

解决方案 #

1. 检查自定义AuthenticationStateProvider的角色声明类型 #

ASP.NET Core授权系统默认会查找**类型为ClaimTypes.Role**的声明来识别用户角色。如果你的FinningAuthProvider中返回的角色声明使用了自定义类型（比如直接用"Role"作为类型名），[Authorize(Roles)]特性将无法匹配。

修改FinningAuthProvider，确保角色声明的Type设置为ClaimTypes.Role：

// 示例：构建ClaimsIdentity时添加角色声明
var claims = new List<Claim>
{
    // 其他用户声明（如用户名、ID等）
    new Claim(ClaimTypes.Name, "用户名"),
    // 角色声明必须使用ClaimTypes.Role作为类型
    new Claim(ClaimTypes.Role, "System Admin"),
    new Claim(ClaimTypes.Role, "Service") // 多角色场景
};
var identity = new ClaimsIdentity(claims, "自定义认证方案名");
return new AuthenticationState(new ClaimsPrincipal(identity));

2. 修正中间件调用顺序 #

确保认证和授权中间件在Razor组件映射之前调用，且顺序正确（先认证，后授权）。修改Program.cs的请求管道配置：

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseAntiforgery();

// 新增以下两行，注意顺序不可颠倒
app.UseAuthentication();
app.UseAuthorization();

app.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode();

3. 验证角色声明的实际类型 #

在ViewUserDetails组件中，查看角色声明的Type字段：

• 如果输出是Role : System Admin，说明声明类型是自定义的"Role"，需要改为ClaimTypes.Role
• 如果输出是http://schemas.microsoft.com/ws/2008/06/identity/claims/role : System Admin，则类型符合默认要求，需排查其他问题

4. 自定义角色声明类型（无法修改声明时的备选方案） #

如果因业务限制无法修改角色声明的Type，可以在授权配置中指定自定义的角色声明类型：

builder.Services.AddAuthorization(options =>
{
    // 指定自定义的角色声明类型，比如你的声明类型是"Role"
    options.RoleClaimType = "Role";
});

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