EF Core中StockItem实体主键配置报错：无法映射Sku属性如何解决？

错误原因 #

1. 第一个错误The entity type 'StockItem' requires a primary key to be defined：
   EF无法将标注了[Key]的Sku实体类型识别为主键——数据库只能存储基本数据类型（如Guid、int），无法直接存储整个实体对象，所以即便加了[Key]特性，EF也不认可这种主键定义。

2. 第二个错误The 'Sku' property 'StockItem.Sku' could not be mapped...：
   你尝试用Fluent API指定Sku作为主键，但EF无法将实体类型映射到数据库列，数据库没有对应的数据类型能存储整个Sku对象，因此报错。

实体设计问题 #

你的StockItem设计不符合EF的数据库映射规则。库存记录和SKU应该是一对一关联：每个SKU对应一条库存记录，此时正确的做法是用SKU的主键（Sku.Id）作为StockItem的主键，同时作为关联SKU的外键。

修复方案 #

1. 修改StockItem实体代码 #

public class StockItem
{
    // 通过SKU实体创建库存记录的构造函数
    public StockItem(Sku sku, uint stockBalance) : this(sku.Id, stockBalance)
    {
        Sku = sku;
    }

    // 通过SKU ID创建库存记录的构造函数
    public StockItem(Guid skuId, uint stockBalance)
    {
        SkuId = skuId;
        StockBalance = stockBalance;
    }

    // EF需要的无参私有构造函数
    private StockItem() {}

    [Key] // 将SkuId设为主键
    public Guid SkuId { get; private set; }

    [Required]
    public uint StockBalance { get; private set; }

    // 导航属性，关联到对应的SKU
    public Sku Sku { get; private set; }
}

2. 可选：Fluent API配置（增强关联约束） #

如果需要明确指定一对一关联规则，可在DbContext的OnModelCreating方法中添加以下配置：

modelBuilder.Entity<StockItem>()
    .HasOne(si => si.Sku) // StockItem关联到一个Sku
    .WithOne() // Sku无需反向导航属性（如果需要，可在Sku中添加public StockItem StockItem { get; private set; }，并改为.WithOne(s => s.StockItem)）
    .HasForeignKey<StockItem>(si => si.SkuId); // 用SkuId作为外键

3. 重新执行迁移命令 #

修改完成后，重新运行Add-Migration命令就能正常生成迁移文件，再执行Update-Database即可同步到数据库。

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