ASP.NET Core WebAPI Post时如何阻止EF Core插入关联数据？

你遇到的问题是因为EF Core默认会把传入的关联实体（这里的ISucursal）识别为新的未追踪实体，所以在调用SaveChanges()时会尝试插入它。下面提供几种可行的解决方案，按推荐程度排序：

1. 使用DTO（数据传输对象）推荐 #

这是最规范的做法，避免直接把数据库实体暴露给API，同时完全控制输入的数据结构：

步骤1：创建DTO类 #

public class DepositoCreateDto {
    public string Descrip { get; set; }
    public string Alias { get; set; }
    public bool Activo { get; set; }
    public int SucursalId { get; set; } // 只传递关联实体的ID
}

步骤2：修改控制器逻辑 #

[HttpPost]
public IActionResult Create([FromBody] DepositoCreateDto dto) {
    if (dto == null) {
        return BadRequest();
    }

    // 先验证关联的Sucursal是否存在
    var existingSucursal = _context.Sucursales.Find(dto.SucursalId);
    if (existingSucursal == null) {
        return BadRequest("指定的Sucursal不存在");
    }

    // 映射DTO到实体
    var deposito = new IDeposito {
        Descrip = dto.Descrip,
        Alias = dto.Alias,
        Activo = dto.Activo,
        Sucursal = existingSucursal // 关联已存在的实体
    };

    _context.Depositos.Add(deposito);
    _context.SaveChanges();

    return CreatedAtRoute("GetDeposito", new { ID = deposito.Id }, deposito);
}

对应的Post请求数据 #

{
    "Descrip": "Neuquen",
    "Alias": "NQN",
    "Activo": true,
    "SucursalId": 1
}

2. 在实体中添加外键属性并传递ID #

如果不想用DTO，可以给IDeposito添加外键属性，让EF Core直接通过ID关联已存在的Sucursal：

修改实体类 #

public class IDeposito {
    [Key]
    public int Id { get; set; }
    public string Descrip { get; set; }
    public string Alias { get; set; }
    public bool Activo { get; set; }
    
    // 添加外键属性（EF Core会自动识别为Sucursal导航属性的外键）
    public int SucursalId { get; set; }
    public ISucursal Sucursal { get; set; }
}

修改Post请求数据 #

只需要传递SucursalId，不需要整个Sucursal对象：

{
    "Descrip": "Neuquen",
    "Alias": "NQN",
    "Activo": true,
    "SucursalId": 1
}

控制器代码不需要修改，EF Core会自动通过SucursalId关联已存在的Sucursal，不会尝试插入新的。

3. 手动标记关联实体为已存在如果必须传递整个Sucursal对象 #

如果你因为某些原因必须传递完整的Sucursal对象，可以在添加Deposito之前，把Sucursal标记为**已存在（Unchanged）**状态：

修改控制器代码 #

[HttpPost]
public IActionResult Create([FromBody] IDeposito postData) {
    if (postData == null) {
        return BadRequest();
    }

    // 先验证Sucursal是否存在（可选但推荐，避免无效ID）
    var existingSucursal = _context.Sucursales.Find(postData.Sucursal.Id);
    if (existingSucursal == null) {
        return BadRequest("指定的Sucursal不存在");
    }

    // 方式1：Attach已存在的实体，EF会将其标记为Unchanged
    _context.Sucursales.Attach(postData.Sucursal);

    // 方式2：手动设置实体状态（和Attach效果一致）
    // _context.Entry(postData.Sucursal).State = EntityState.Unchanged;

    _context.Depositos.Add(postData);
    _context.SaveChanges();

    return CreatedAtRoute("GetDeposito", new { ID = postData.Id }, postData);
}

这样EF Core就不会尝试插入Sucursal，只会关联已有的记录。

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