.NET Core Web API含外键表的POST/PATCH/PUT实现问题

问题根源 #

1. 你的Order实体类中，Customer导航属性可能被标记为必填（比如[Required]特性），但请求时仅传递CustomerId会导致Customer对象为null，触发模型验证400错误。
2. 当你传入完整Customer对象时，EF Core默认会尝试插入该Customer，但对应的CustomerId已存在于数据库，因此触发主键冲突。

解决方案 #

1. 调整实体类配置 #

确保CustomerId作为外键正确配置，同时允许Customer导航属性为可选：

public class Order
{
    public int OrderId { get; set; }
    // 外键字段标记为必填
    [Required]
    public int CustomerId { get; set; }
    // 导航属性设为可空，避免模型验证要求传入完整Customer对象
    public Customer? Customer { get; set; }
}

或者在DbContext中用Fluent API明确配置关系（更推荐）：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Order>()
        .HasOne(o => o.Customer)
        .WithMany(c => c.Orders) // 如果Customer实体包含Orders集合
        .HasForeignKey(o => o.CustomerId)
        .IsRequired(); // 确保外键CustomerId必填，但导航属性可为null
}

2. 修改POST方法逻辑 #

仅接收CustomerId，先验证关联Customer是否存在，再添加Order，避免EF尝试插入重复Customer：

[HttpPost]
public async Task<ActionResult<Order>> PostOrder(Order order)
{
    if (_context.Orders == null)
    {
        return Problem("Entity set 'ecopowerdatabaseContext.Orders' is null.");
    }

    // 验证关联的Customer是否存在
    var customerExists = await _context.Customers.AnyAsync(c => c.CustomerId == order.CustomerId);
    if (!customerExists)
    {
        return BadRequest("指定的Customer不存在");
    }

    // 仅添加Order，EF会自动通过CustomerId关联已存在的Customer
    _context.Orders.Add(order);
    try
    {
        await _context.SaveChangesAsync();
    }
    catch (DbUpdateException)
    {
        if (OrderExists(order.OrderId))
        {
            return Conflict();
        }
        else
        {
            throw;
        }
    }

    return CreatedAtAction("GetOrder", new { id = order.OrderId }, order);
}

3. 用DTO优化请求（推荐） #

创建专门的请求DTO，分离API请求与数据库实体，仅传递必要字段：

// 创建订单的请求DTO
public class CreateOrderRequest
{
    [Required]
    public int CustomerId { get; set; }
    // 添加Order的其他必填字段，比如下单时间、总金额等
    public DateTime OrderDate { get; set; }
    public decimal TotalAmount { get; set; }
}

修改POST方法接收DTO并映射为实体：

[HttpPost]
public async Task<ActionResult<Order>> PostOrder(CreateOrderRequest request)
{
    if (_context.Orders == null)
    {
        return Problem("Entity set 'ecopowerdatabaseContext.Orders' is null.");
    }

    if (!await _context.Customers.AnyAsync(c => c.CustomerId == request.CustomerId))
    {
        return BadRequest("指定的Customer不存在");
    }

    var order = new Order
    {
        CustomerId = request.CustomerId,
        OrderDate = request.OrderDate,
        TotalAmount = request.TotalAmount
        // 映射其他字段
    };

    _context.Orders.Add(order);
    try
    {
        await _context.SaveChangesAsync();
    }
    catch (DbUpdateException)
    {
        if (OrderExists(order.OrderId))
        {
            return Conflict();
        }
        else
        {
            throw;
        }
    }

    return CreatedAtAction("GetOrder", new { id = order.OrderId }, order);
}

此时在Swagger中测试，只需传递如下JSON即可：

{
  "customerId": 1,
  "orderDate": "2024-05-20T12:00:00",
  "totalAmount": 100.00
}

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