使用Package Console Manager迁移时遇System.InvalidOperationException错误求助

错误信息 #

使用Package Manager Console执行数据库迁移时，抛出如下异常：

System.InvalidOperationException: 'Cannot use table 'Quote' for entity type 'Sample' since it is being used for entity type 'Author' and potentially other entity types, but there is no linking relationship. Add a foreign key to 'Sample' on the primary key properties and pointing to the primary key on another entity typed mapped to 'Quote'.'

问题根源 #

代码中存在两处导致EF Core映射逻辑混乱的问题：

• 属性名与表名冲突：Author类的集合属性名为Quote，EF Core默认会将该集合对应的关联表推断为Quote；而Sample类已通过[Table("Quote")]指定自身映射到Quote表，这导致EF认为两个实体都要使用同一表，却未识别到正确的关联关系。
• DbSet命名不规范：RepositoryContext中DbSet<Author>使用单数命名Author，不符合EF常规的复数命名约定，进一步干扰了映射推断逻辑。

修复步骤 #

1. 修改Author类的集合属性名 #

将Author中的集合属性名改为复数形式（如Quotes），明确其集合语义，避免与表名冲突：

// Author.cs
using Sieve.Attributes;
using System.Collections.Generic;

namespace Entities.Models
{
    public class Author : BaseEntity
    {
        [Sieve(CanFilter = true, CanSort = true)]
        public string Name { get; set; }
        [Sieve(CanFilter = true, CanSort = true)]
        public string Email { get; set; }
        // 修改为复数属性名
        public ICollection<Sample> Quotes { get; set; }
    }
}

2. 规范DbSet命名（推荐） #

将RepositoryContext中的DbSet<Author>改为复数形式Authors，符合EF的约定俗成：

// RepositoryContext.cs
using Entities.Models;
using Microsoft.EntityFrameworkCore;

namespace Entities
{
    public class RepositoryContext : DbContext
    {
        public RepositoryContext(DbContextOptions options)
            : base(options)
        {
        }
        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            base.OnModelCreating(modelBuilder);
            modelBuilder.ApplyConfigurationsFromAssembly(typeof(RepositoryContext).Assembly);
        }

        public DbSet<Sample> Samples { get; set; }
        // 修改为复数命名
        public DbSet<Author> Authors { get; set; }
    }
}

3. 可选：通过Fluent API明确关联关系 #

若需更精准的控制，可在OnModelCreating中用Fluent API直接指定一对多关系，消除约定推断的不确定性：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    modelBuilder.ApplyConfigurationsFromAssembly(typeof(RepositoryContext).Assembly);

    // 明确Author与Sample的一对多关联
    modelBuilder.Entity<Author>()
        .HasMany(a => a.Quotes)
        .WithOne(s => s.Author)
        .HasForeignKey(s => s.AuthorId);
}

4. 重新执行迁移 #

完成修改后，执行以下命令重新生成迁移并更新数据库：

Add-Migration FixQuoteTableMapping
Update-Database

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