EF Core配置角色多权限关联时迁移表结构异常解决方法

你当前的Fluent API配置没有显式声明RoleAssignedPermissions与Permission的关联逻辑和外键映射，EF Core会按默认约定将二者识别为单向一对多关系：即一条RoleAssignedPermissions记录关联多条Permission记录，因此自动在Permissions表生成了RoleAssignedPermissionsId外键列，不会生成你预期的关联映射结构。
另外你当前定义的RoleAssignedPermissions实体结构本身不符合关联表的设计规范，根据业务场景可以选择以下两种标准实现方式：

如果角色和权限的关联关系不需要存储额外信息（比如分配时间、操作人、生效状态这类附加字段），完全不需要单独定义RoleAssignedPermissions实体，EF Core会自动生成中间关联表，代码改动最小。

1. 给两个基础实体补充反向导航属性：

class Role
{ 
    public string Id { get; set; }
    public string Name { get; set; }
    public ICollection<Permission> Permissions { get; set; } = new List<Permission>();
}

class Permission
{ 
    public string Id { get; set; }
    public string Name { get; set; }
    public ICollection<Role> Roles { get; set; } = new List<Role>();
}

2. 删除原有RoleAssignedPermissions相关的实体定义和配置代码，在OnModelCreating中添加如下多对多配置即可：

modelBuilder.Entity<Role>(entity =>
{
    entity.HasKey(x => x.Id);
    entity.HasMany(r => r.Permissions)
          .WithMany(p => p.Roles)
          .UsingEntity(j => j.ToTable("RoleAssignedPermissions"));
});

modelBuilder.Entity<Permission>(entity =>
{
    entity.HasKey(x => x.Id);
});

执行迁移后会生成三张表：

• Roles：包含Id、Name字段
• Permissions：包含Id、Name字段，不会生成多余外键
• RoleAssignedPermissions：自动生成RoleId、PermissionId联合外键作为主键，专门维护角色和权限的多对多关联，完全满足单角色分配多权限的需求。

如果需要给角色-权限的关联记录存储附加信息，就需要显式定义联接实体，注意联接实体的单条记录对应「一个角色+一个权限」的单条映射，不能直接在联接实体中放ICollection<Permission>类型的集合属性，正确写法如下：

1. 修正实体定义：

class Role
{ 
    public string Id { get; set; }
    public string Name { get; set; }
    public ICollection<RoleAssignedPermission> AssignedPermissions { get; set; } = new List<RoleAssignedPermission>();
}

class Permission
{ 
    public string Id { get; set; }
    public string Name { get; set; }
    public ICollection<RoleAssignedPermission> AssignedPermissions { get; set; } = new List<RoleAssignedPermission>();
}

// 修正后的联接实体，单条记录对应一组角色-权限映射
class RoleAssignedPermission
{ 
    public string Id { get; set; }
    public string RoleId { get; set; }
    public Role Role { get; set; }
    public string PermissionId { get; set; }
    public Permission Permission { get; set; }
    // 可在此处添加自定义字段，例如：
    // public DateTime AssignedAt { get; set; }
    // public string AssignedBy { get; set; }
}

2. 编写对应Fluent API配置：

modelBuilder.Entity<Role>(entity =>
{
    entity.HasKey(x => x.Id);
});

modelBuilder.Entity<Permission>(entity =>
{
    entity.HasKey(x => x.Id);
});

modelBuilder.Entity<RoleAssignedPermission>(entity =>
{
    entity.HasKey(x => x.Id);
    // 配置与Role表的关联
    entity.HasOne(rap => rap.Role)
          .WithMany(r => r.AssignedPermissions)
          .HasForeignKey(rap => rap.RoleId);
    // 配置与Permission表的关联
    entity.HasOne(rap => rap.Permission)
          .WithMany(p => p.AssignedPermissions)
          .HasForeignKey(rap => rap.PermissionId);
});

执行迁移后生成的RoleAssignedPermission表会包含Id、RoleId、PermissionId以及你自定义的额外字段，查询时通过Include关联导航属性即可获取指定角色下的所有权限。

注意：如果坚持保留原RoleAssignedPermissions中直接持有ICollection<Permission>的结构，本质是将该实体作为与Role一对一的聚合根，这种设计下它和Permission就是标准一对多关系，必然会在Permission表生成外键，无法实现通过独立关联表维护映射的需求，不建议采用这种设计。

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