EF Core 6带导航属性实体数据插入失败解决方案

帖子已更新，附可直接落地的解决方案。

问题场景 #

• 基于EF Core Code First模式开发，配置User（用户）和Car（车辆）的一对多关系，数据库迁移、更新操作、GET接口调用、POST新增User记录均正常，但POST新增Car记录始终失败。
• 先后尝试Fluent API、Data Annotations两种方式配置关系，给导航属性添加virtual关键字、POST请求中传入嵌套导航属性对象，均报相同错误。以下是复现问题的最小化代码示例。

实体定义 #

User实体：

public class User
{
    public int Id { get; set; }
    public string Age { get; set; }
    public string Name { get; set; }
    public string City { get; set; }
    public string Country { get; set; }

    // 导航属性：一个用户名下可有多辆车
    public List<Car> Cars { get; set; }
}

Car实体：

public class Car
{
    public int Id { get; set; }
    public int Year { get; set; }
    public string Plate { get; set; }

    // 外键+导航属性：一辆车归属一个用户
    public int UserId { get; set; }
    public User User { get; set; }
}

DbContext配置 #

public MyPersonalProjectContext(DbContextOptions<MyPersonalProjectContext> options) : base(options)
{
}

public DbSet<User> Users { get; set; }
public DbSet<Car> Cars { get; set; }

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置User-Car一对多关系，开启级联删除
    modelBuilder.Entity<Car>()
        .HasOne(u => u.User)
        .WithMany(c => c.Cars)
        .HasForeignKey(u => u.UserId)
        .HasConstraintName("FK_User_Cars")
        .OnDelete(DeleteBehavior.Cascade);
}

报错复现 #

向api/cars接口提交如下POST请求：

{
    "year": 2012,
    "plate": "YY-11-BB",
    "userId": 2
}

接口返回400校验错误：

{
    "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "traceId": "00-36feeb71fcd60b67da499091bf94598a-1b14d3e2c48fc635-00",
    "errors": {
        "User": [
            "The User field is required."
        ]
    }
}

尝试在请求体中传入空的user字段绕过校验，依然报错：

{
    "year": 2012,
    "plate": "YY-11-BB",
    "userId": 2,
    "user": []
}

原始POST接口代码：

public async Task<ActionResult<Car>> PostCar(Car car)
{
    if (_context.Cars == null)
    {
        return Problem("Entity set 'MyPersonalProjectContext.Cars'  is null.");
    }

    _context.Cars.Add(car);
    await _context.SaveChangesAsync();

    return CreatedAtAction("GetCar", new { id = car.Id }, car);
}

解决步骤 #

1. 定义新增操作专用DTO #

不要直接将数据库实体作为接口入参，创建仅包含新增所需字段的DTO类，从根源上规避非必要的导航属性校验：

public class CreateCarDTO
{
    public int Id { get; set; }
    public int Year { get; set; }
    public string Plate { get; set; }
    public int UserId { get; set; }
}

注：DTO即数据传输对象，核心作用是隔离接口入参/出参与数据库实体，解决字段校验、循环序列化等常见问题。

2. 改造POST接口逻辑 #

将接口入参替换为新建的DTO，手动校验关联的用户是否存在后，组装完整的Car实体再写入数据库：

[HttpPost]
public async Task<ActionResult<Car>> PostCar(CreateCarDTO request)
{
    var user = await _context.Users.FindAsync(request.UserId);
    if (user == null)
    {
        return NotFound();
    }
    var newCar = new Car
    {
        Year = request.Year,
        Plate = request.Plate,
        User = user
    };

    _context.Cars.Add(newCar);
    await _context.SaveChangesAsync();
    return await GetCar(newCar.UserId);
}

3. 给导航属性添加JsonIgnore特性 #

为避免接口返回数据时出现JSON循环引用异常，给Car类的User导航属性添加忽略序列化特性：

using System.Text.Json.Serialization;

public class Car
{
    public int Id { get; set; }
    public int Year { get; set; }
    public string Plate { get; set; }

    // 外键+导航属性：一辆车归属一个用户
    public int UserId { get; set; }
    [JsonIgnore]
    public User User { get; set; }
}

完成以上配置后，POST新增Car接口即可正常运行。

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