ASP.NET应用POST带外键新实体时新增外键实体而非引用现有实体问题

你遇到的报错核心是AutoMapper与EF Core的跟踪逻辑冲突，具体触发逻辑如下：

1. 你的Feature实体仅声明了FeatureType导航属性，未显式定义外键字段FeatureTypeID，仅通过Fluent API配置了影子外键，该字段不会在实体类中暴露。
2. AutoMapper的ReverseMap()规则在将FeatureDto映射为Feature实体时，识别到FeatureDto的FeatureTypeID字段与Feature导航属性FeatureType的ID字段匹配，会自动实例化一个新的FeatureType对象，仅给ID赋值为请求传入的FeatureTypeID，其余字段（如Name）均为默认空值。
3. EF Core上下文跟踪到新创建的Feature实体关联了一个未被当前上下文跟踪的FeatureType对象，会默认将其识别为待插入的新实体，最终触发FeatureTypes表的插入操作，因为Name字段非空导致插入失败。

优先推荐第一种方案，符合EF Core最佳实践，改造成本最低：

方案1：在Feature实体中显式声明外键属性 #

直接在Feature类中添加与影子外键同名的显式外键字段：

public class Feature : Entity
{
    public string Name { get; set; }
    public decimal Price { get; set; }
    // 新增显式外键字段，与Fluent API配置的外键名一致
    public Guid FeatureTypeID { get; set; }
    public FeatureType FeatureType { get; set; }
    public ICollection<ConfigurationFeatureState> Configurations { get; set; }
}

修改后AutoMapper会自动将FeatureDto的FeatureTypeID直接映射到实体的同名字段，不会再自动实例化FeatureType导航属性。EF Core识别到外键字段有值、导航属性为空时，会直接使用该外键关联已有FeatureType记录，不会触发新增操作。

方案2：修改AutoMapper映射规则，禁止自动构造导航属性 #

如果你不想在实体中暴露外键字段，可以手动配置反向映射规则，忽略FeatureType导航属性的自动构造，同时手动给影子外键赋值：

1. 调整AutoMapper配置，替换原有的ReverseMap()逻辑：

CreateMap<Feature, FeatureDto>()
    .ForMember(dto => dto.FeatureTypeID, opt => opt.MapFrom(db => db.FeatureType.ID));
// 手动配置反向映射，忽略FeatureType导航属性
CreateMap<FeatureDto, Feature>()
    .ForMember(entity => entity.FeatureType, opt => opt.Ignore());

2. 调整CreateAsync方法，手动给影子外键赋值：

public async Task<TDto> CreateAsync(TDto newEntityDto)
{
    var entity = Mapper.Map<TEntity>(newEntityDto);
    // 手动设置影子外键值
    if (newEntityDto is FeatureDto featureDto)
    {
        _repository.GetDbContext().Entry(entity).Property("FeatureTypeID").CurrentValue = featureDto.FeatureTypeID;
    }
    _repository.Create(entity);
    await UnitOfWork.SaveAsync();

    var dto = Mapper.Map<TDto>(entity);
    return dto;
}

方案3：预查询关联的FeatureType实体 #

在保存Feature前先根据ID查询已有FeatureType，赋值给导航属性，让EF Core识别为已存在的实体：

// 仅适用于Feature的CreateAsync实现，泛型方法需要额外处理类型判断
public async Task<FeatureDto> CreateAsync(FeatureDto newEntityDto)
{
    var entity = Mapper.Map<Feature>(newEntityDto);
    // 预查询关联的FeatureType
    var existingFeatureType = await _featureTypeRepository.GetByIdAsync(newEntityDto.FeatureTypeID);
    entity.FeatureType = existingFeatureType;
    
    _repository.Create(entity);
    await UnitOfWork.SaveAsync();

    var dto = Mapper.Map<FeatureDto>(entity);
    return dto;
}

该方案需要多执行一次数据库查询，性能不如前两种方案，仅适合特殊业务场景使用。

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