调用RESTful API提交POST请求后触发SqlException错误排查

问题描述 #

尝试插入新职位（Vacancy）时触发以下SQL异常：

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

当前操作是向依赖employerId的vacancies表插入数据，且已传入存在的employerId值，但仍出现该错误。

相关代码实现 #

Controller层代码 #

public IActionResult CreateVacancy([FromBody] VacancyDTO vacancyDTO)
{
    if (vacancyDTO == null)
        return BadRequest(ModelState);

    var existed = _vacancyRepository.GetVacancyByTitle(vacancyDTO.Title);

    if (existed != null)
    {
        ModelState.AddModelError("Existed", "Vacancy with this title already existed");
        return StatusCode(422, ModelState);
    }

    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }

    var vacancy = _mapper.Map<Vacancy>(vacancyDTO);

    if (!_vacancyRepository.CreateVacancy(vacancy))
    {
        ModelState.AddModelError("Not Created", "Failed To Create");
        return StatusCode(500, ModelState);
    }

    return Ok("Successfully created");
}

Repository层代码 #

public bool CreateVacancy(Vacancy vacancy)
{
    _context.Vacancies.Add(vacancy);
    return Save();
}

问题原因分析 #

这个错误的本质是Entity Framework错把关联的Employer实体当成了新数据，想要插入它，而不是仅仅关联已存在的Employer的ID。常见触发情况：

• AutoMapper映射时，从VacancyDTO中不仅映射了EmployerId，还自动生成了一个Employer实体对象（哪怕只填了Id字段）
• EF的实体状态跟踪机制会把这个生成的Employer标记为Added状态，调用SaveChanges()时就会尝试插入新的Employer记录，进而触发标识列不能手动插入的限制

解决方案 #

方案1：调整AutoMapper配置 #

确保映射时仅关联EmployerId，不创建/映射完整的Employer实体。示例配置：

CreateMap<VacancyDTO, Vacancy>()
    .ForMember(dest => dest.Employer, opt => opt.Ignore());

方案2：手动设置Employer实体状态 #

如果确实需要映射Employer对象，在保存前将其状态改为Unchanged，告知EF该实体已存在、无需插入：

public bool CreateVacancy(Vacancy vacancy)
{
    if (vacancy.Employer != null && vacancy.EmployerId != 0)
    {
        _context.Entry(vacancy.Employer).State = EntityState.Unchanged;
    }
    _context.Vacancies.Add(vacancy);
    return Save();
}

方案3：仅传递EmployerId而非完整实体 #

修改VacancyDTO，只保留EmployerId字段，去掉Employer相关的其他属性，从根源避免映射出完整的Employer对象。

内容的提问来源于stack exchange，提问作者Ahmed Abd El-Samie