ASP.NET Core中EF Code First创建外键引用时提示约束不存在

问题原因 #

1. 语法错误：DestinationsList 实体类的主键特性少了闭合的方括号，导致EF模型解析异常，生成的迁移脚本不符合预期。
2. 外键命名冲突：你之前配置 DestinationsList 和 Region 的一对一关系时，EF自动生成了名为 FK_DestinationsLists_Regions_AirportCode 的外键约束。后续新增 Flight 和 DestinationsList 的关联配置时，EF会尝试修改 DestinationsList 表的 AirportCode 字段属性，自动生成删除旧约束的步骤，如果旧约束已经被异常删除或者迁移脚本生成逻辑异常，就会触发约束不存在的报错。
3. 字段用途冲突：你同时把 DestinationsList.AirportCode 既作为指向 Region 的外键，又作为 Flight 外键的参考主键，且 DestinationsList 本身的主键是自增Id，这种双重用途会导致EF的约束生成逻辑混乱。

解决方案 #

步骤1：修正实体类语法错误，补充必要配置 #

public class DestinationsList
{
    // 补全特性的闭合方括号
    [Key, DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public int Id { get; private set; }
    // 作为参考主键必须唯一非空
    [Required]
    public string AirportCode { get; private set; }
    public Region Region { get; set; }
    public IEnumerable<Flight> Flights { get; set; }
}

// Region的AirportShortCode作为一对一参考主键必须唯一
public class Region
{
    [Key, DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public int Id { get; set; }
    public string AirportCode { get; set; }
    [Required]
    public string AirportShortCode { get; set; }
    public DestinationsList DestinationsLists { get; set; }
}

public class Flight
{
    public int Id { get; set; }
    [Required]
    public string ArrivalAirportCode { get; set; }
    public DestinationsList ArrivalAirport { get; set; }
}

步骤2：修改DbContext配置，手动指定约束名避免冲突 #

public DbSet<DestinationsList> DestinationsLists { get; set; }
public DbSet<Region> Regions { get; set; }
// 修正DbSet命名和实体名对应避免歧义
public DbSet<Flight> Flights { get; set; }

// 补充唯一索引配置
builder.Entity<DestinationsList>()
    .HasIndex(x => x.AirportCode)
    .IsUnique();
builder.Entity<Region>()
    .HasIndex(x => x.AirportShortCode)
    .IsUnique();

builder.Entity<DestinationsList>()
                .HasOne(i => i.Region)
                .WithOne(i => i.DestinationsLists)
                .HasPrincipalKey<Region>(i => i.AirportShortCode)
                .HasForeignKey<DestinationsList>(i => i.AirportCode)
                // 手动指定一对一外键的约束名，避免命名冲突
                .HasConstraintName("FK_DestinationsLists_Regions_AirportShortCode");

builder.Entity<Flight>()
                .HasOne(x => x.ArrivalAirport)
                .WithMany(x => x.Flights)
                .HasForeignKey(x => x.ArrivalAirportCode)
                .HasPrincipalKey(x => x.AirportCode)
                // 手动指定Flight外键约束名
                .HasConstraintName("FK_Flights_DestinationsLists_ArrivalAirportCode");

步骤3：重新生成迁移并应用 #

1. 删除之前生成的错误迁移：运行命令 Remove-Migration（包管理器控制台）或者 dotnet ef migrations remove（.NET CLI）
2. 生成新的迁移：运行 Add-Migration AddFlightArrivalAirportFK 或者 dotnet ef migrations add AddFlightArrivalAirportFK
3. 打开新生成的迁移文件，检查是否存在删除 FK_DestinationsLists_Regions_AirportCode 约束的代码，如果有手动删除该行
4. 应用迁移到数据库：运行 Update-Database 或者 dotnet ef database update

如果你的数据库中已经存在旧的 FK_DestinationsLists_Regions_AirportCode 约束，可以先手动进入数据库删除该约束，再执行上述步骤。

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