EF Core 6添加模型关联时出现OnDelete错误及影子属性问题

你遇到的报错和警告来自两个核心问题：

• 多重级联删除路径冲突：SQL Server 不允许单条删除操作触发多条可到达同一张表的级联删除路径。你的模型中删除Device记录时存在两条到达OrganisationRental的级联路径：
  1. Device 级联删除关联的DistributorRental，再级联删除关联的OrganisationRental
  2. Device 直接级联删除关联的OrganisationRental
     这就是第一次更新数据库抛出级联路径错误的直接原因。
• 关联配置存在歧义：你在配置DistributorRental和OrganisationRental的关系时，没有显式绑定双向导航属性、也没有在实体中定义对应的外键字段，EF Core 无法识别你在两个实体中分别定义的DistributorRental引用导航和OrganisationRentals集合导航属于同一段关联，会误判存在多段独立的未配置关系，自动生成多余的影子外键属性，同时抛出外键匹配歧义的警告。

按照以下步骤调整即可彻底解决问题：

1. 补全实体类的外键属性
   在OrganisationRental类中显式添加对应DistributorRental关联的外键字段，避免EF Core自动生成影子属性：

   public class OrganisationRental {
     // 原有属性保持不变
     public string DistributorRentalId { get; set; } = "";
     public DistributorRental DistributorRental { get; set; } = null!;
   }
   

2. 编写完整无歧义的Fluent API配置
   在DbContext的OnModelCreating方法中，为所有关联显式指定双向导航属性、外键字段、删除行为，不要留半配置的关联关系：

   // 配置Device与DistributorRental的一对多关系
   builder.Entity<Device>()
     .HasMany(d => d.DistributorRentals)
     .WithOne(dr => dr.Device)
     .HasForeignKey(dr => dr.DeviceId)
     .OnDelete(DeleteBehavior.NoAction);
   
   // 配置Device与OrganisationRental的一对多关系
   builder.Entity<Device>()
     .HasMany(d => d.OrganisationRentals)
     .WithOne(or => or.Device)
     .HasForeignKey(or => or.DeviceId)
     .OnDelete(DeleteBehavior.NoAction);
   
   // 配置DistributorRental与OrganisationRental的一对多关系
   builder.Entity<DistributorRental>()
     .HasMany(dr => dr.OrganisationRentals)
     .WithOne(or => or.DistributorRental)
     .HasForeignKey(or => or.DistributorRentalId)
     .OnDelete(DeleteBehavior.NoAction);
   

3. 清理并重新生成迁移
   删除之前生成的存在错误配置的迁移文件，重新执行迁移生成命令生成新迁移，再执行数据库更新命令即可，不会再出现警告或报错。

补充说明：如果需要实现删除上级租赁记录时自动处理下级租赁记录的逻辑（比如删除DistributorRental时自动给关联的OrganisationRental的End字段赋值），不要使用数据库级级联删除，在业务逻辑层编写代码手动处理即可，避免触发SQL Server的多重级联路径限制。

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