EFC设计优先模式下配置一对多关系时遇SqlException：无效列名GuestListId

问题场景 #

在使用EF Core设计优先（Design First）模式配置实体一对多关系时，触发SqlException: Invalid column name 'GuestListId'错误：

• 一对一关系配置可正常运行：

public class GuestList
{
    public Guid GuestListId { get; set; }
    public Guest? Guest { get; set; }
}

• 将GuestList中的导航属性改为ICollection<Guest>后触发报错：

public class GuestList
{
    public Guid GuestListId { get; set; }
    public ICollection<Guest>? Guest { get; set; }
}

• 按建议在Guest类中添加GuestList导航属性后，仍报错：

public class Guest
{
    public Guid GuestId { get; set; }
    public string Name { get; set; }

    public GuestList GuestList { get; set; }
}

此时观察数据库发现：Guest表已生成GuestListId列，但GuestList表错误生成了GuestId列，与预期的一对多结构不符。

原因分析 #

1. EF Core对一对一和一对多关系的约定规则不同：一对一关系默认采用共享主键或在主表添加外键，而一对多关系要求在多的一方（Guest）添加指向一的一方（GuestList）主键的外键列。
2. 手动修改数据库结构后，实体模型与数据库元数据不同步，导致EF Core仍按旧的关系约定生成查询，引发列名不存在的错误。

解决步骤 #

1. 修正实体命名规范（可选但推荐）：将GuestList中的导航属性命名为复数Guests，符合EF Core约定：

public class GuestList
{
    public Guid GuestListId { get; set; }
    public ICollection<Guest>? Guests { get; set; }
}

2. 生成并应用EF迁移：
   • 在Package Manager Console中执行迁移创建命令：

     Add-Migration ConfigureOneToManyGuestRelationship
     

   • 执行更新命令将迁移同步到数据库：

     Update-Database
     

3. 验证数据库结构：迁移完成后，GuestList表仅保留主键GuestListId，Guest表新增GuestListId外键列，此时一对多关系配置生效，报错消失。

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