Entity Framework Core迁移时外键引发循环/级联路径错误的解决方法

错误原因 #

SQL Server不允许同一个表存在多条级联删除路径。你的Manufacture类有两个指向Photo的关联（Logo和CoverPhoto），EF默认对非空外键（int类型）启用级联删除——当删除Manufacture记录时，会尝试同时级联删除Logo和CoverPhoto对应的Photo记录，这触发了SQL Server的限制，从而抛出错误。

解决方案 #

1. 显式补充外键属性（可选但推荐） #

先在Manufacture类里显式添加CoverPhotoId属性，让映射关系更清晰：

public class Manufacture : BaseEntity
{
    // ... 原有代码
    public Photo CoverPhoto { get; set; }
    public int CoverPhotoId { get; set; } // 添加此属性，若允许为空则用int?
    // ... 原有代码
}

2. 通过Fluent API禁用级联删除 #

在你的DbContext类的OnModelCreating方法中，手动配置两个外键的级联删除行为，改为Restrict或NoAction：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置Logo关联，禁用级联删除
    modelBuilder.Entity<Manufacture>()
        .HasOne(m => m.Logo)
        .WithOne() // Photo无反向导航属性，用WithOne()
        .HasForeignKey<Manufacture>(m => m.LogoId)
        .OnDelete(DeleteBehavior.Restrict);

    // 配置CoverPhoto关联，禁用级联删除
    modelBuilder.Entity<Manufacture>()
        .HasOne(m => m.CoverPhoto)
        .WithOne()
        .HasForeignKey<Manufacture>(m => m.CoverPhotoId)
        .OnDelete(DeleteBehavior.Restrict);

    // 其他实体配置...
}

• DeleteBehavior.Restrict：删除Manufacture时，不会自动删除关联的Photo；若Photo被删除，Manufacture的外键会被设为null（仅当外键可空时生效），否则会报错。
• DeleteBehavior.NoAction：类似Restrict，但完全依赖数据库层面的限制，不会自动处理外键值。

3. （可选）将外键改为可空类型 #

如果Logo/CoverPhoto是可选的（允许Manufacture没有Logo或CoverPhoto），可以直接将外键改为int?，EF会默认禁用级联删除：

public int? LogoId { get; set; }
public int? CoverPhotoId { get; set; }

注意：此方法仅适用于业务上允许关联为空的场景。

后续操作 #

完成上述修改后，重新执行迁移命令：

add-migration FixCascadeDeleteIssue
update-database

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