Entity Framework复合主键实体更新报错：主键属性无法修改

你在更新带有复合主键（Type+Id）的Animal实体时遇到报错：

该属性是键的一部分，因此无法修改或标记为已修改。要更改带有标识外键的现有实体的主体，请先删除依赖项并调用'SaveChanges'，然后将依赖项与新主体关联。

问题根源：直接将实体状态设为EntityState.Modified时，EF会尝试更新包括复合主键在内的所有字段，但EF Core不允许修改主键值，因此触发错误。

方案1：仅更新非主键属性（推荐） #

1. 调整Mapper配置，排除主键字段 #

确保映射时不会覆盖主键值：

CreateMap<OriginAnimal, NewInformationAnimal>()
    .ReverseMap()
    .ForMember(dest => dest.Type, opt => opt.Ignore())
    .ForMember(dest => dest.Id, opt => opt.Ignore());

2. 修改Repository的更新逻辑 #

不要直接标记整个实体为Modified，利用EF的追踪机制更新非主键字段：

public void UpdateAnimal(Animal existingAnimal)
{
    // EF自动追踪现有实体的变更，无需手动设置状态
    _animalContext.SaveChanges();
}

3. 调整Controller调用流程 #

先从数据库获取原始实体，再映射更新数据：

// 根据复合主键查询数据库中的实体
var existingAnimal = _animalRepository.GetAnimalByCompositeKey(originalAnimal.Type, originalAnimal.Id);
// 将新数据映射到现有实体（仅更新非主键字段）
_mapper.Map(newInformationAnimal, existingAnimal);
// 执行更新
_animalRepository.UpdateAnimal(existingAnimal);

方案2：若必须修改主键（业务特殊场景） #

如果业务上确实需要修改主键值（比如合并实体），按照错误提示的步骤操作：

1. 删除旧主键对应的实体
2. 调用SaveChanges()提交删除
3. 创建新主键的实体并插入数据库

示例代码：

// 删除旧实体
var oldAnimal = _animalRepository.GetAnimalByCompositeKey(oldType, oldId);
_animalContext.Animals.Remove(oldAnimal);
_animalContext.SaveChanges();

// 插入新主键的实体
var newAnimal = new Animal { Type = newType, Id = newId, /* 其他属性赋值 */ };
_animalContext.Animals.Add(newAnimal);
_animalContext.SaveChanges();

内容的提问来源于stack exchange，提问作者Olaff Velazquez Escalante