EF Core配置实体时遇CS1061错误及迁移失败求助

错误1：CS1061 'CollectionCollectionBuilder<Products, OrderProducts>' 不包含 'HasForeignKey' 的定义 #

原因分析 #

你在OrderProducts的配置中错误使用HasMany+WithMany配置多对多关系，但OrderProducts是手动定义的连接表，它与Products、Orders应该是一对多关系，而非直接多对多。HasMany+WithMany返回的CollectionCollectionBuilder不支持HasForeignKey方法，这是报错的核心原因。

修复步骤 #

1. 修改OnModelCreating中OrderProducts的配置逻辑：

// 替换原有的OrderProducts配置代码
modelBuilder.Entity<OrderProducts>()
    .HasOne(op => op.Product) // 连接表关联单个Product
    .WithMany(p => p.Orders) // 一个Product对应多个OrderProducts
    .HasForeignKey(op => op.ProductId);

modelBuilder.Entity<OrderProducts>()
    .HasOne(op => op.Order) // 连接表关联单个Order
    .WithMany(o => o.OrderProducts) // 一个Order对应多个OrderProducts
    .HasForeignKey(op => op.OrderId);

2. 修正OrderProducts实体的导航属性（连接表应关联单个实体，而非集合）：

namespace CafeApiProject.Models
{
    public class OrderProducts
    {
        public Guid OrderId { get; set; }
        public Guid ProductId { get; set; }
        
        // 修正为单个实体类型
        [ForeignKey("ProductId")]
        public Products Product { get; set; }   
        [ForeignKey("OrderId")]
        public Orders Order { get; set; }
    }
}

错误2：执行迁移时提示"实体类型 'OrderProducts' 需要定义主键" #

原因分析 #

虽然你使用了[PrimaryKey]特性，但部分低版本EF Core不支持该特性（EF Core 5.0及以上才引入），或者特性未被框架正确识别。

修复步骤 #

在OnModelCreating中通过Fluent API显式配置复合主键，比特性配置更可靠：

modelBuilder.Entity<OrderProducts>()
    .HasKey(op => new { op.OrderId, op.ProductId });

同时可以移除OrderProducts类上的[PrimaryKey]特性，避免冲突。

额外实体关系修正 #

你的Orders实体存在两处错误：

1. 错误的自关联导航属性：

// 删除这段无效的自关联代码
modelBuilder.Entity<Orders>()
    .HasOne(p => p.Order)
    .WithMany(c => c.Orders)
    .HasForeignKey(p => p.OrderId );

2. 错误的Order导航属性（主键不能关联连接表），替换为集合类型：

namespace CafeApiProject.Models
{
    public class Orders
    {
        [Key]
        public Guid OrderId { get; set; }
        
        public Guid CustomerId { get; set; }
        [Required]
        [ForeignKey("CustomerId")] // 修正外键指向CustomerId，而非Id
        public Customers Customer { get; set; }
        
        public Guid EmployeeId { get; set; }
        [Required]
        [ForeignKey("EmployeeId")]
        public Employees Employee { get; set; }
        
        public string OrderList { get; set; }

        // 新增与连接表的正确导航属性
        public ICollection<OrderProducts> OrderProducts { get; set; }
    }
}

完整修正后的核心代码片段 #

AppDbContext.cs #

using CafeApiProject.Models;
using Microsoft.EntityFrameworkCore;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace CafeApiProject
{
    public class AppDbContext : DbContext
    {
        public DbSet<ProductCategory> ProductCategories { get; set; }
        public DbSet<Products> Products { get; set; }
        public DbSet<OrderProducts> OrderProducts { get; set; }
        public DbSet<Employees> Employees { get; set; }
        public DbSet<Orders> Orders { get; set; }
        public DbSet<Customers> Customers { get; set; }

        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=CafeDb;Trusted_Connection=True;");
        }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            // 产品与分类的一对多关系
            modelBuilder.Entity<Products>()
               .HasOne(p => p.Category)
               .WithMany(c => c.Products)
               .HasForeignKey(p => p.CategoryId);

            // 配置连接表复合主键
            modelBuilder.Entity<OrderProducts>()
                .HasKey(op => new { op.OrderId, op.ProductId });

            // 连接表与产品的一对多
            modelBuilder.Entity<OrderProducts>()
                .HasOne(op => op.Product)
                .WithMany(p => p.Orders)
                .HasForeignKey(op => op.ProductId);

            // 连接表与订单的一对多
            modelBuilder.Entity<OrderProducts>()
                .HasOne(op => op.Order)
                .WithMany(o => o.OrderProducts)
                .HasForeignKey(op => op.OrderId);

            // 订单与员工的一对多
            modelBuilder.Entity<Orders>()
                .HasOne(e => e.Employee)
                .WithMany(c => c.Orders)
                .HasForeignKey(e => e.EmployeeId);

            // 订单与客户的一对多
            modelBuilder.Entity<Orders>()
                .HasOne(c => c.Customer)
                .WithMany(c => c.Orders)
                .HasForeignKey(p => p.CustomerId);
        }
    }
}

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