Entity Framework Core调用AddRange时首个实体导航属性被置空的原因？

核心问题：错误的一对一关系配置 #

你把ApplicationUser和ApplicationRole配置为一对一关系，但业务场景里一个角色显然需要被多个用户关联，这种关系不匹配是报错的根本原因。EF Core处理一对一关系时，要求每个角色实例只能被一个用户引用，当你试图把同一个角色赋值给多个用户时，会触发内部状态冲突，导致首个用户的CompanyRole被置空，进而引发外键约束错误。

解决方案步骤 #

1. 修正实体关系为一对多 #

先调整实体类和模型配置，匹配一对多的业务逻辑：

实体类修改

public class ApplicationUser: IdentityUser
{
    // 其他原有属性
    public string CompanyRoleId { get; set; } // 确保外键属性存在
    public ApplicationRole CompanyRole { get; set; }
}

public class ApplicationRole : IdentityRole
{
    public string Id { get; set; }
    public string Name { get; set; }
    // 添加用户集合导航属性，体现一对多关系
    public ICollection<ApplicationUser> Users { get; set; } = new List<ApplicationUser>();
}

模型配置修改

builder
    .HasOne(x => x.CompanyRole)
    .WithMany(r => r.Users) // 配置为一对多：一个角色对应多个用户
    .HasForeignKey<ApplicationUser>(au => au.CompanyRoleId)
    .OnDelete(DeleteBehavior.Restrict);

2. 优化批量添加代码 #

修正关系后，推荐直接用外键属性赋值（而非导航属性），效率更高且避免跟踪冲突：

var viewerRole = await _rolesService.GetViewerRole();
var roleId = viewerRole.Id;

var usersToAdd = emails.Select(email => new ApplicationUser
{
    FirstName = request.Name,
    Email = email,
    CompanyRoleId = roleId // 直接设置外键，无需依赖导航属性跟踪
});

_dbContext.Set<ApplicationUser>().AddRange(usersToAdd);
_dbContext.SaveChanges();

备选方案：使用无跟踪角色实例（若需保留导航属性赋值） #

如果因特殊需求必须通过导航属性关联，可将角色实例设置为无跟踪状态，或创建仅含Id的角色实例：

方式1：解除角色实例的跟踪

var viewerRole = await _rolesService.GetViewerRole();
_dbContext.Entry(viewerRole).State = EntityState.Detached; // 解除EF跟踪

var usersToAdd = emails.Select(email => new ApplicationUser
{
    FirstName = request.Name,
    Email = email,
    CompanyRole = viewerRole
});

_dbContext.Set<ApplicationUser>().AddRange(usersToAdd);
_dbContext.SaveChanges();

方式2：创建仅含Id的角色实例

var viewerRoleId = (await _rolesService.GetViewerRole()).Id;

var usersToAdd = emails.Select(email => new ApplicationUser
{
    FirstName = request.Name,
    Email = email,
    CompanyRole = new ApplicationRole { Id = viewerRoleId } // 仅赋值Id，无需完整实例
});

_dbContext.Set<ApplicationUser>().AddRange(usersToAdd);
_dbContext.SaveChanges();

为什么逐个添加能临时解决？ #

逐个添加时，每次保存后你分离了实体，相当于每次都用一个“干净”的角色实例关联新用户，避免了EF跟踪上下文的冲突，但这种方式效率低下，并非最优解。

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