EntityFramework.Jet插入更新报错：多值字段致INSERT INTO失败

问题场景 #

使用Visual Studio连接本地Access学生示例数据库，通过EF Core反向生成数据库模型后，查询、删除记录功能正常，但执行POST请求新增记录时抛出以下异常：

Microsoft.EntityFrameworkCore.DbUpdateException: An error occurred while saving the entity changes. See the inner exception for details.
---> System.Data.OleDb.OleDbException (0x80004005): An INSERT INTO query cannot contain a multi-valued field.

相关代码：

//CODE IS LISTED HERE.
group.MapPost("/", async (Student input) =>
{
    //Add Record
    using (var context = new ModelContext())
    {
        context.Students.Add(input);
        context.Attach(input);
        await context.SaveChangesAsync();
        return TypedResults.Created($"/api/Store/{input.Id}", input);
    }
})
.WithName("CreateStudent")
.WithOpenApi();

问题根源 #

这个错误核心是Access的多值字段（Multi-Valued Field）被EF Core错误映射为普通实体属性。Access的多值字段本质是隐藏的关联表，EF反向生成模型时若将其识别为集合类型的普通属性，插入时直接赋值就会触发该错误。

解决步骤 #

1. 定位多值字段 #

打开反向生成的Student实体类，查找集合类型的属性（比如public List<string> Courses { get; set; }），这类就是引发问题的多值字段映射。

2. 修正实体映射 #

根据需求选择以下两种方式：

• 保留多值功能：将多值字段配置为导航属性，关联对应的隐藏表。在ModelContext的OnModelCreating方法中添加配置：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      // 假设多值字段是Courses，对应关联表Student_Courses
      modelBuilder.Entity<Student>()
          .HasMany(s => s.Courses)
          .WithOne()
          .HasForeignKey("StudentId");
  }
  

  同时确保Student类中的Courses属性为public List<Course> Courses { get; set; }，并生成对应的Course实体类。

• 弃用多值字段：重新运行EF反向生成命令时，用-ExcludeColumns参数排除多值字段：

  Scaffold-DbContext "Provider=Microsoft.ACE.OLEDB.12.0;Data Source=C:\your-db.accdb" Microsoft.EntityFrameworkCore.Odbc -OutputDir Models -ExcludeColumns "MultiValueFieldName"
  

  或者直接手动删除实体类中的多值字段属性。

3. 清理冗余代码 #

原代码中context.Students.Add(input);后调用context.Attach(input);属于冗余操作（Add已将实体标记为Added状态），同时要确保不手动给自增ID赋值，让Access自动生成：

group.MapPost("/", async (Student input) =>
{
    using (var context = new ModelContext())
    {
        input.Id = 0; // 清空自增ID，由数据库自动生成
        context.Students.Add(input);
        await context.SaveChangesAsync();
        return TypedResults.Created($"/api/Store/{input.Id}", input);
    }
})
.WithName("CreateStudent")
.WithOpenApi();

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