.NET 6中PositionGroup关联模型Post API报错修复咨询

错误核心原因有两点：

1. 请求体中positions[0].positionGroup传入了字符串值，但该属性是PositionGroup类型，无法完成JSON类型转换。
2. 实体导航属性在反序列化时触发了不必要的验证，导致出现"positionGroup字段必填"的错误。

1. 修正请求体 #

创建PositionGroup时，无需在子对象Position中传递positionGroup（导航属性）和idPosGr（外键）——EF Core会自动将新建PositionGroup的ID关联到子Position的外键上。修正后的请求体如下：

{
  "idPoGr": 0,
  "name": "G1",
  "positions": [
    {
      "idPos": 0,
      "positionName": "string",
      "createDate": "2024-10-02T05:17:13.314Z"
    }
  ]
}

2. 优化实体模型（可选但推荐） #

• 遵循C#命名规范，将导航属性首字母大写，提升代码可读性；
• 给Position的PositionGroup属性添加[JsonIgnore]，让JSON序列化器忽略该属性，避免反序列化时的类型转换和验证问题：

public class PositionGroup
{
    [Key]
    public int IdPoGr { get; set; }

    [Required, MaxLength(150)]
    public string Name { get; set; }

    public ICollection<Position>? Positions { get; set; }
}

public class Position
{
    [Key]
    public int IdPos { get; set; }

    [Required, MaxLength(150)]
    public string PositionName { get; set; }

    [ForeignKey("PositionGroup")]
    public int IdPosGr { get; set; }

    [Column(TypeName = "date")]
    public DateTime CreateDate { get; set; }

    [JsonIgnore]
    public PositionGroup? PositionGroup { get; set; }
}

3. 使用DTO接收请求（推荐最佳实践） #

直接用实体类接收HTTP请求易暴露内部细节，也容易引发序列化问题。建议创建专用的DTO类：

public class PositionGroupCreateDto
{
    public string Name { get; set; }
    public List<PositionCreateDto> Positions { get; set; }
}

public class PositionCreateDto
{
    public string PositionName { get; set; }
    public DateTime CreateDate { get; set; }
}

在API控制器中接收DTO并映射为实体：

[HttpPost]
public async Task<IActionResult> CreatePositionGroup(PositionGroupCreateDto dto)
{
    var positionGroup = new PositionGroup
    {
        Name = dto.Name,
        Positions = dto.Positions.Select(p => new Position
        {
            PositionName = p.PositionName,
            CreateDate = p.CreateDate.Date
        }).ToList()
    };

    _context.PositionGroups.Add(positionGroup);
    await _context.SaveChangesAsync();

    return CreatedAtAction(nameof(GetPositionGroup), new { id = positionGroup.IdPoGr }, positionGroup);
}

4. 确认EF Core关联配置 #

确保DbContext中正确配置实体关联关系：

public class AppDbContext : DbContext
{
    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }

    public DbSet<PositionGroup> PositionGroups { get; set; }
    public DbSet<Position> Positions { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Position>()
            .HasOne(p => p.PositionGroup)
            .WithMany(g => g.Positions)
            .HasForeignKey(p => p.IdPosGr)
            .OnDelete(DeleteBehavior.Cascade);
    }
}

.NET 6默认启用Nullable Reference Types，实体中的可空属性（如PositionGroup?）可能在反序列化时被误判为必填。使用DTO或[JsonIgnore]是最有效的规避方式，同时也符合分层架构的最佳实践。

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