ASP.NET MVC（非Core）启用迁移后报错：无法确定实体关联主体端

报错内容：
Unable to determine the principal end of an association between the types 'ClassLibraries.Entities.Product' and 'ClassLibraries.Entities.Category'. The principal end of this association must be explicitly configured using either the relationship fluent API or data annotations.
中文说明：无法确定类型ClassLibraries.Entities.Product与ClassLibraries.Entities.Category之间关联的主体端，必须通过关系Fluent API或数据注解显式配置该关联的主体端。

核心原因 #

当Entity Framework无法自动推断实体间关联的主体端（比如一对多关系中"一"的一方）和依赖端（"多"的一方）时，就会抛出该错误，通常是因为两个实体互相包含导航属性但未明确关系规则。

方法一：使用数据注解配置 #

假设这是一对多关系（一个分类对应多个产品），直接在实体类中标记依赖端的外键关联：

实体类代码示例 #

Category（主体端，"一"的一方）

namespace ClassLibraries.Entities
{
    public class Category
    {
        public int Id { get; set; }
        public string Name { get; set; }
        
        // 导航属性：一个分类对应多个产品
        public ICollection<Product> Products { get; set; } = new List<Product>();
    }
}

Product（依赖端，"多"的一方）

using System.ComponentModel.DataAnnotations.Schema;

namespace ClassLibraries.Entities
{
    public class Product
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public decimal Price { get; set; }
        
        // 外键字段
        public int CategoryId { get; set; }
        
        // 标记导航属性对应的外键，明确依赖关系
        [ForeignKey(nameof(CategoryId))]
        public Category Category { get; set; }
    }
}

如果是一对一关系，可在主体端的导航属性上添加[Required]，或用[InverseProperty]明确关联双方的导航属性。

方法二：使用Fluent API配置 #

在你的DbContext类的OnModelCreating方法中，显式定义关联规则，灵活性更强：

using Microsoft.EntityFrameworkCore;
using ClassLibraries.Entities;

public class YourDbContext : DbContext
{
    public DbSet<Product> Products { get; set; }
    public DbSet<Category> Categories { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 配置Product与Category的一对多关系，指定Category为主体端
        modelBuilder.Entity<Product>()
            .HasOne(p => p.Category) // Product属于一个Category
            .WithMany(c => c.Products) // Category包含多个Product
            .HasForeignKey(p => p.CategoryId) // 外键字段
            .IsRequired(); // 可选：设置是否允许Product无关联的Category
    }
}

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