Entity Framework多对多关系配置报错：List<int>需定义主键

错误原因 #

你遇到的The entity type 'List<int>' requires a primary key to be defined错误，根源在Student类里的List<int> CompletedCourses属性。EF Core会自动把集合类型的属性识别为实体集合，但int是值类型，不是带主键的实体类，EF无法为它生成有效的数据库映射，所以抛出这个错误。

修正方案 #

根据你的需求，分两种情况处理：

情况1：仅需记录学生选修的课程（不需要区分是否完成）

直接移除List<int> CompletedCourses，利用EF Core的隐式多对多关系配置即可。同时建议在类的构造函数中初始化集合属性，避免空引用问题。

修正后的Student类：

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;

namespace Advisment.Models
{
public class Student
{
    public Student()
    {
        Courses = new List<Course>();
    }
    
    public int Id { get; set; }
    public string Name { get; set; }

    public int MajorId { get; set; }
    public int AdvisorId { get; set; }

    public ICollection<Course> Courses { get; set; }

    public Advisor Advisor { get; set; }
    public Major Major { get; set; }
}
}

修正后的Course类：

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;

namespace Advisment.Models
{
public class Course
{
    public Course()
    {
        Students = new List<Student>();
    }
    
    [Key]
    public int CourseId { get; set; }
    public string CourseName { get; set; }

    public int MajorId { get; set; }
    
    public ICollection<Student> Students { get; set; }

    public Major Major { get; set; }
}
}

如果需要自定义多对多连接表的名称，可以在DbContext的OnModelCreating方法中显式配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Student>()
        .HasMany(s => s.Courses)
        .WithMany(c => c.Students)
        .UsingEntity(j => j.ToTable("StudentCourseLinks")); // 自定义连接表名
}

情况2：需要区分学生已完成/未完成的课程

这种情况EF Core的隐式多对多无法满足，需要创建一个显式连接实体来存储额外的状态信息（比如是否完成）。

1. 创建连接实体StudentCourse：

using System.ComponentModel.DataAnnotations;

namespace Advisment.Models
{
public class StudentCourse
{
    // 复合主键
    public int StudentId { get; set; }
    public int CourseId { get; set; }

    // 标记课程是否完成
    public bool IsCompleted { get; set; }

    // 导航属性
    public Student Student { get; set; }
    public Course Course { get; set; }
}
}

2. 修改Student类，替换原有的Courses集合为连接实体集合：

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;

namespace Advisment.Models
{
public class Student
{
    public Student()
    {
        StudentCourses = new List<StudentCourse>();
    }
    
    public int Id { get; set; }
    public string Name { get; set; }

    public int MajorId { get; set; }
    public int AdvisorId { get; set; }

    public ICollection<StudentCourse> StudentCourses { get; set; }

    public Advisor Advisor { get; set; }
    public Major Major { get; set; }
}
}

3. 修改Course类，替换原有的Students集合为连接实体集合：

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;

namespace Advisment.Models
{
public class Course
{
    public Course()
    {
        StudentCourses = new List<StudentCourse>();
    }
    
    [Key]
    public int CourseId { get; set; }
    public string CourseName { get; set; }

    public int MajorId { get; set; }
    
    public ICollection<StudentCourse> StudentCourses { get; set; }

    public Major Major { get; set; }
}
}

4. 在DbContext中配置连接实体的关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置复合主键
    modelBuilder.Entity<StudentCourse>()
        .HasKey(sc => new { sc.StudentId, sc.CourseId });

    // 配置与Student的关系
    modelBuilder.Entity<StudentCourse>()
        .HasOne(sc => sc.Student)
        .WithMany(s => s.StudentCourses)
        .HasForeignKey(sc => sc.StudentId);

    // 配置与Course的关系
    modelBuilder.Entity<StudentCourse>()
        .HasOne(sc => sc.Course)
        .WithMany(c => c.StudentCourses)
        .HasForeignKey(sc => sc.CourseId);
}

验证修改 #

完成上述修改后，重新执行迁移命令：

dotnet ef migrations add InitialCreate
dotnet ef database update

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