EF Core如何仅用现有Exercise的Id创建关联，不更新实体？

问题场景 #

创建新的WorkoutProgram对象，添加ExerciseInWorkoutProgram并关联数据库中已存在的Exercise，尝试保存时出现以下错误：

SqlException: Cannot insert explicit value for identity column in table 'Exercises' when IDENTITY_INSERT is set to OFF.

出现错误的代码如下：

客户端代码 #

var exercise= await HttpClient.GetFromJsonAsync<Exercise>("Exercice/1");
var workoutProgram = new WorkoutProgram();
workoutProgram.Exercices = new List<ExerciseInWorkoutProgram>();
workoutProgram.Exercices.Add(new ExerciseInWorkoutProgram() {Exercice = exercise});
_httpClient.PostAsJsonAsync<WorkoutProgram>($"WorkoutProgram", workoutProgram);

服务端代码 #

var operation = await _dbContext.WorkoutPrograms.AddAsync(workoutProgram);
await _dbContext.SaveChangesAsync();

相关实体定义 #

• WorkoutProgram

public int Id { get; set; }
public List<ExerciseInWorkoutProgram> Exercices { get; set; }

• ExerciseInWorkoutProgram

public int Id { get; set; }
public int Sets { get; set; }
public int Reps { get; set; }
public Exercise Exercice { get; set; }

• Exercise

public int Id { get; set; }
public string Content { get; set; }

曾尝试修改ExerciseInWorkoutProgram，添加ExerciseId并将Exercise标记为[NotMapped]，虽能正常保存，但查询时需手动获取关联的Exercise，体验不佳。

解决方案：使用Stub实体方法 #

通过创建仅包含主键的“Stub”实体，告知EF Core该Exercise已存在于数据库中，仅需建立关联而不执行插入/更新操作，完美解决问题。

修改后的服务端代码 #

foreach (var exerciseInProgram in workoutProgram.Exercices)
{
    // 创建仅含Id的Stub实体
    var existingExerciseStub = new Exercise { Id = exerciseInProgram.Exercice.Id };
    // 告知EF Core该实体已存在，状态设为Unchanged
    _dbContext.Attach(existingExerciseStub);
    // 替换导航属性为Stub实体
    exerciseInProgram.Exercice = existingExerciseStub;
}

var operation = await _dbContext.WorkoutPrograms.AddAsync(workoutProgram);
await _dbContext.SaveChangesAsync();

或者更简洁的写法，直接设置现有Exercise对象的状态：

foreach (var exerciseInProgram in workoutProgram.Exercices)
{
    // 标记Exercise为已存在，无需变更
    _dbContext.Entry(exerciseInProgram.Exercice).State = EntityState.Unchanged;
}

var operation = await _dbContext.WorkoutPrograms.AddAsync(workoutProgram);
await _dbContext.SaveChangesAsync();

原理说明 #

从客户端传递完整的Exercise对象时，EF Core会默认将其标记为Added状态，执行SaveChanges时会尝试插入该实体。通过Stub实体或直接设置状态为Unchanged，可以明确告诉EF Core：这个Exercise已经存在于数据库中，只需要用它的Id来建立与ExerciseInWorkoutProgram的关联，不需要对其执行任何变更操作。

这种方法保留了实体的导航属性，后续查询时可以直接通过Include方法加载关联的Exercise，无需手动查询，完全符合EF Core的使用逻辑。

内容的提问来源于stack exchange，提问作者Henrik Landström