在ASP.NET Core 6 Identity中添加角色实现菜单权限管理

1. 配置Identity启用角色支持 #

首先在Program.cs中配置Identity时，明确启用角色功能，确保框架能识别并操作现有角色表：

builder.Services.AddDefaultIdentity<ApplicationUser>(options => options.SignIn.RequireConfirmedAccount = true)
    .AddRoles<IdentityRole>() // 启用角色支持，指定角色类型
    .AddEntityFrameworkStores<ApplicationDbContext>();

如果你的角色表使用自定义主键（比如Guid），需要调整泛型参数：

// 假设ApplicationUser和CustomRole都用Guid作为主键
builder.Services.AddIdentity<ApplicationUser, CustomRole>(options => options.SignIn.RequireConfirmedAccount = true)
    .AddEntityFrameworkStores<ApplicationDbContext>()
    .AddDefaultTokenProviders();

2. 映射现有角色数据表 #

如果系统已存在AspNetRoles等标准Identity表，只需确保你的ApplicationDbContext正确继承并映射这些表：

public class ApplicationDbContext : IdentityDbContext<ApplicationUser, IdentityRole, string>
{
    public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
        : base(options)
    {
    }

    // 如果现有表名与默认不一致，用FluentAPI指定表名
    protected override void OnModelCreating(ModelBuilder builder)
    {
        base.OnModelCreating(builder);
        // 比如现有角色表名为"SysRoles"，则：
        // builder.Entity<IdentityRole>().ToTable("SysRoles");
        // 若有自定义角色字段，扩展IdentityRole并映射
        // builder.Entity<CustomRole>().Property(r => r.Description).HasColumnName("Description");
    }
}

注意：如果现有表结构和Identity默认的AspNetRoles完全一致，上述代码无需额外修改，框架会自动关联。

3. 注册时为用户分配角色 #

在注册逻辑中，创建用户后直接为其分配默认角色（比如"普通用户"），示例代码如下：

public async Task<IActionResult> OnPostAsync(string returnUrl = null)
{
    returnUrl ??= Url.Content("~/");
    ExternalLogins = (await _signInManager.GetExternalAuthenticationSchemesAsync()).ToList();
    if (ModelState.IsValid)
    {
        var user = new ApplicationUser { UserName = Input.Email, Email = Input.Email };
        var result = await _userManager.CreateAsync(user, Input.Password);
        if (result.Succeeded)
        {
            // 为新用户分配默认角色
            await _userManager.AddToRoleAsync(user, "普通用户");
            
            _logger.LogInformation("User created a new account with password.");
            // 后续确认邮件、登录逻辑...
        }
        // 错误处理...
    }
    // 返回注册页面
    return Page();
}

如果是后台管理注册用户，可添加角色选择下拉框，让管理员指定用户角色。

4. 登录后的角色验证与权限控制 #

控制器/Action层面的权限控制 #

使用[Authorize]特性指定允许访问的角色，只有对应角色的用户才能访问该接口/页面：

// 仅允许管理员访问的控制器
[Authorize(Roles = "管理员")]
public class AdminController : Controller
{
    public IActionResult Dashboard()
    {
        return View();
    }
}

// 允许管理员或编辑者访问的Action
[Authorize(Roles = "管理员,编辑者")]
public IActionResult EditContent()
{
    return View();
}

视图层面的菜单权限控制 #

在视图（比如_Layout.cshtml的菜单区域）中，通过User.IsInRole()判断当前用户角色，动态显示/隐藏菜单：

<ul class="navbar-nav">
    <li class="nav-item">
        <a class="nav-link" asp-area="" asp-controller="Home" asp-action="Index">首页</a>
    </li>
    <!-- 仅管理员可见的菜单 -->
    @if (User.IsInRole("管理员"))
    {
        <li class="nav-item">
            <a class="nav-link" asp-area="" asp-controller="Admin" asp-action="Dashboard">管理后台</a>
        </li>
    }
    <!-- 普通用户和编辑者可见的菜单 -->
    @if (User.IsInRole("普通用户") || User.IsInRole("编辑者"))
    {
        <li class="nav-item">
            <a class="nav-link" asp-area="" asp-controller="Content" asp-action="MyContent">我的内容</a>
        </li>
    }
</ul>

5. 角色管理（可选） #

如果需要动态添加/修改角色，可通过RoleManager<IdentityRole>实现，示例代码：

private readonly RoleManager<IdentityRole> _roleManager;

public RoleManagementController(RoleManager<IdentityRole> roleManager)
{
    _roleManager = roleManager;
}

public async Task<IActionResult> CreateRole(string roleName)
{
    if (!await _roleManager.RoleExistsAsync(roleName))
    {
        var role = new IdentityRole(roleName);
        await _roleManager.CreateAsync(role);
    }
    return RedirectToAction("RolesList");
}

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