EF Core问题：仅导航属性可用，无法通过ID属性插入含外键对象

嘿，我之前也遇到过EF Core里这种只靠外键ID插入失败的情况，结合你给出的模型代码，咱们来梳理下问题和解决办法。

你的当前模型代码（整理后） #

[Table("groups")]
public class Group {
    public int? Id { get; set; }
    [JsonIgnore]
    public virtual ICollection<Membership> Members { get; set; }
}

[Table("identities")]
public class Identity {
    public int? Id { get; set; }
    [JsonIgnore]
    public virtual ICollection<Membership> MemberOf { get; set; }
}

[Table("memberships")]
public partial class Membership {
    [Column("group_id")]
    public int? GroupId { get; set; } // 推测你原本的代码是这个字段
    // 应该还有对应的identity_id字段
    [Column("identity_id")]
    public int? IdentityId { get; set; }
}

可能的问题根源 #

• 外键与实体关系未明确配置：EF Core需要明确知道Membership里的group_id和identity_id对应Group和Identity的主键，否则它无法将单独设置的ID与关联实体绑定。
• 主键配置不明确：Group和Identity的Id是可空的int?，EF Core默认不会自动将可空int识别为自增主键，这可能导致实体跟踪或关联时出现异常。
• 实体状态未正确告知上下文：当你只设置外键ID而不关联导航属性时，EF Core可能不知道这些ID对应的实体已经存在于数据库中，会尝试插入新的Group/Identity而非仅关联外键。

具体解决步骤 #

1. 完善实体的外键与关系配置

首先给Membership类补充完整的外键属性，并通过数据注解明确关联关系：

[Table("memberships")]
public partial class Membership {
    // 建议外键非可空（除非你的业务允许空关联）
    [Column("group_id")]
    public int GroupId { get; set; }

    [Column("identity_id")]
    public int IdentityId { get; set; }

    // 用ForeignKey注解明确外键对应的导航属性
    [ForeignKey(nameof(GroupId))]
    public virtual Group Group { get; set; }

    [ForeignKey(nameof(IdentityId))]
    public virtual Identity Identity { get; set; }
}

同时给Group和Identity的主键添加[Key]注解，明确主键身份：

[Table("groups")]
public class Group {
    [Key]
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)] // 明确是自增主键
    public int? Id { get; set; }
    [JsonIgnore]
    public virtual ICollection<Membership> Members { get; set; }
}

[Table("identities")]
public class Identity {
    [Key]
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public int? Id { get; set; }
    [JsonIgnore]
    public virtual ICollection<Membership> MemberOf { get; set; }
}

2. 仅用外键ID插入时，告知上下文实体状态

如果你不想关联导航属性，只想通过外键ID插入Membership，需要让EF Core知道对应的Group/Identity已经存在于数据库中，避免它尝试插入新的实体：

using (var context = new YourDbContext())
{
    var newMembership = new Membership
    {
        GroupId = 1, // 数据库中已存在的Group的ID
        IdentityId = 2 // 数据库中已存在的Identity的ID
    };

    // 告知上下文：这些ID对应的实体已存在，无需插入
    context.Entry(new Group { Id = 1 }).State = EntityState.Unchanged;
    context.Entry(new Identity { Id = 2 }).State = EntityState.Unchanged;

    context.Memberships.Add(newMembership);
    await context.SaveChangesAsync();
}

3. （可选）用Fluent API配置关系（更灵活）

如果你倾向于用Fluent API而非数据注解，可以在DbContext的OnModelCreating方法中配置关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Membership>()
        .HasOne(m => m.Group)
        .WithMany(g => g.Members)
        .HasForeignKey(m => m.GroupId);

    modelBuilder.Entity<Membership>()
        .HasOne(m => m.Identity)
        .WithMany(i => i.MemberOf)
        .HasForeignKey(m => m.IdentityId);

    // 配置Group的主键为自增
    modelBuilder.Entity<Group>()
        .Property(g => g.Id)
        .ValueGeneratedOnAdd();

    modelBuilder.Entity<Identity>()
        .Property(i => i.Id)
        .ValueGeneratedOnAdd();
}

这样配置后，不管是用导航属性还是直接设置外键ID，EF Core都能正确处理插入操作了。核心是让EF Core明确外键与实体的关联关系，并且在仅用ID时告知上下文实体的存在状态。

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