.NET 5 Web API EF生成模型控制器POST无关联数据提交报错如何解决

• 测试时保留了Swagger自动生成的customerDetails默认数组值，EF Core的变更追踪会将数组内的CustomerDetail实例识别为需要和ClubStateDetail一同插入的关联数据
• 默认的customerDetails样例中clubState值为0，没有对应已存在的ClubState记录，且关联属性的序列化/映射异常导致EF生成了不存在的ClubStateNavigationClubStateId字段作为外键执行SQL，触发报错
• 额外注意：你现有POST代码存在笔误，DbContext中定义的DbSet名称为ClubStateDetails（末尾带s），代码中_context.ClubStateDetail.Add少了末尾的s，需要修正否则编译报错

无需修改现有代码，直接在Swagger中调整请求体，删除或置空customerDetails字段，仅保留ClubState本身的核心字段即可，请求体示例：

{
  "clubStateId": 1,
  "name": "Gold"
}

提交该请求即可正常插入ClubState记录，不需要携带还未创建的Customer关联数据。

避免后续同类问题建议做如下优化：

1. 使用DTO做参数隔离
   不要在接口参数中直接使用EF生成的实体类，专门创建用于新增请求的DTO类，仅保留接口需要接收的字段，避免关联属性被意外提交：

public class CreateClubStateDto
{
    public int ClubStateId { get; set; }
    [Required]
    [MaxLength(50)]
    public string Name { get; set; }
}

调整接口代码，将DTO映射为实体后再存入数据库：

[HttpPost]
public async Task<ActionResult<ClubStateDetail>> PostClubStateDetail(CreateClubStateDto dto)
{
    var clubStateDetail = new ClubStateDetail
    {
        ClubStateId = dto.ClubStateId,
        Name = dto.Name
    };
    // 修正DbSet名称的笔误
    _context.ClubStateDetails.Add(clubStateDetail);
    await _context.SaveChangesAsync();
    return CreatedAtAction("GetClubStateDetail", new { id = clubStateDetail.ClubStateId }, clubStateDetail);
}

2. 配置序列化规则忽略循环引用
   在启动配置中添加JSON序列化规则，避免实体的关联属性被不必要的序列化输出，同时解决循环引用问题：

// .NET 5 Startup.cs 配置示例
services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.ReferenceHandler = System.Text.Json.Serialization.ReferenceHandler.IgnoreCycles;
    });

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