EF6配置同类型嵌套实体自引用关联迁移报无效对象名错误

现有实现 #

使用技术框架为 Entity Framework 6，当前定义的自引用实体代码如下：

public class Bike
{
   public Guid Id { get; set; }

   public Guid ParentBikeId { get; set; }

   public virtual Bike ChildBike { get; set; }

   public virtual ICollection<Bike> ParentedBikes { get; set; }
}

OnModelCreating 中配置的关系映射代码如下：

builder
  .HasOne(x => x.ChildBike)
  .WithMany(x => x.ParentedBikes)
  .HasForeignKey(x => x.ParentBikeId);

执行EF迁移时抛出如下错误：

Microsoft.Data.SqlClient.SqlException (0x80131904): Invalid object name 'RecruitmentStages'

问题分析 #

1. 自引用配置存在逻辑错误 #

当前的自引用一对多关系配置方向完全颠倒，不符合一对多关系的语义：

• 外键ParentBikeId存储的是当前实体关联的父级记录ID，对应的单个导航应该是「当前实体所属的父Bike」，集合导航应该是「父Bike下的所有子Bike」
• 现有配置将ParentBikeId绑定到ChildBike导航上，等价于声明ParentBikeId存储的是子级Bike的ID，同时声明单个子Bike可以归属到多个父Bike下，既不符合属性命名语义，也不符合自引用层级的业务逻辑。
• 额外问题：ParentBikeId为非空Guid类型，自引用场景下顶级节点（无父节点的根记录）没有对应的父ID值，非空外键会直接导致根节点插入失败，同时自引用关系默认开启的级联删除会产生循环级联路径，EF生成迁移时本身就会抛出约束错误。

2. RecruitmentStages表不存在报错的诱因 #

这个报错和Bike实体的配置没有直接关联，属于迁移状态不一致问题，常见诱因包括：

• DbContext中注册了RecruitmentStage实体，但生成的迁移脚本遗漏了该表的创建逻辑，迁移应用后数据库中实际不存在这张表
• 迁移历史记录不匹配：数据库中__MigrationHistory表记录的已应用迁移版本，和项目内的迁移文件版本不一致，EF判定表已存在但实际未创建
• 连接字符串配置错误，EF连接到了未初始化对应表结构的其他数据库实例。

修复方案 #

1. 调整自引用实体与映射配置，二选一即可：
   • 方案1（语义清晰，推荐）：补全父级导航，修正关系方向
     首先修改实体类：

     public class Bike
     {
        public Guid Id { get; set; }
        // 外键改为可空类型，支持根节点无父级的场景
        public Guid? ParentBikeId { get; set; }
        // 父级导航：当前Bike所属的父Bike
        public virtual Bike ParentBike { get; set; }
        // 子级集合导航：当前Bike下的所有子Bike
        public virtual ICollection<Bike> ChildBikes { get; set; }
     }
     

     然后修改FluentAPI配置：

     builder
       .HasOne(x => x.ParentBike)
       .WithMany(x => x.ChildBikes)
       .HasForeignKey(x => x.ParentBikeId)
       // 关闭级联删除，避免循环级联路径错误
       .OnDelete(DeleteBehavior.Restrict);
     

   • 方案2（保留现有实体结构不新增导航）：调整映射关系，修正外键约束
     首先将ParentBikeId改为Guid?可空类型，然后修改配置：

     builder
       .HasOne(x => x.ChildBike)
       .WithMany()
       .HasForeignKey(x => x.ParentBikeId)
       .OnDelete(DeleteBehavior.Restrict);
     

2. 修复迁移状态问题：
   • 删除项目Migrations文件夹下所有未应用的错误迁移文件
   • 校验连接字符串指向的目标数据库，清空数据库中__MigrationHistory表内不匹配的版本记录，开发环境可直接删除旧库重置
   • 重新执行Add-Migration生成新的迁移脚本，检查脚本内容是否同时包含Bikes表、RecruitmentStages表的创建逻辑，确认无误后执行Update-Database应用迁移。

内容的提问来源于stack exchange，提问作者Emil Mąka