EF Core同时创建主从实体时复合外键关联报错求助

错误场景与原因 #

当你为City实体配置包含自增Id和外键StateId的复合主键后，向已存在的State添加City可正常工作，但同时创建新State和关联City时，会抛出如下错误：

System.InvalidOperationException: The value of 'City.StateId' is unknown when attempting to save changes. This is because the property is also part of a foreign key for which the principal entity in the relationship is not known.

原因分析：
新创建的State的Id由数据库自增生成，在调用SaveChangesAsync()前该值不存在。而City的复合主键要求所有键值在保存时必须确定，EF Core无法提前获取未生成的State.Id来填充City.StateId，因此触发报错。

解决方案一：拆分保存操作，先保存主实体 #

先单独保存新创建的State，获取数据库生成的Id后，再为关联的City设置StateId并保存。修改Add方法如下：

public virtual async Task<ActionResult<V>> Add(V viewModel)
{
    var _mapped = _mapper.Map<V, T>(viewModel);
    // 暂存关联的City集合
    var cities = _mapped.Cities?.ToList() ?? new List<City>();
    // 清空State的Cities集合，避免一起添加
    _mapped.Cities = new List<City>();

    // 先保存State，获取生成的Id
    _service.Create(_mapped);
    await _service.SaveAsync();

    // 为每个City设置StateId并关联导航属性，然后添加保存
    foreach (var city in cities)
    {
        city.StateId = _mapped.Id;
        city.State = _mapped;
        _dbContext.Set<City>().Add(city);
    }
    await _service.SaveAsync();

    return Ok(viewModel);
}

解决方案二：用事务保证操作原子性 #

若担心拆分保存导致数据不一致，可使用EF Core事务包裹两次保存操作，确保操作要么全部成功，要么全部回滚：

public virtual async Task<ActionResult<V>> Add(V viewModel)
{
    var _mapped = _mapper.Map<V, T>(viewModel);
    using (var transaction = await _dbContext.Database.BeginTransactionAsync())
    {
        try
        {
            var cities = _mapped.Cities?.ToList() ?? new List<City>();
            _mapped.Cities = new List<City>();

            _service.Create(_mapped);
            await _service.SaveAsync();

            foreach (var city in cities)
            {
                city.StateId = _mapped.Id;
                city.State = _mapped;
                _dbContext.Set<City>().Add(city);
            }
            await _service.SaveAsync();

            await transaction.CommitAsync();
        }
        catch (Exception)
        {
            await transaction.RollbackAsync();
            throw;
        }
    }

    return Ok(viewModel);
}

备选方案：调整复合主键设计（业务允许时） #

若业务场景允许，可将City的复合主键替换为单一自增Id，同时通过唯一约束实现业务上的唯一性要求（例如StateId+Name组合唯一），避免复合主键包含外键的问题。配置示例：

public void Configure(EntityTypeBuilder<City> builder)
{            
    builder.HasKey(x => x.Id);
    builder.HasIndex(x => new { x.StateId, x.Name }).IsUnique();
}

内容的提问来源于stack exchange，提问作者David.Warwick