更新Instructor实体触发SQLIntegrityConstraintViolationException：name列不能为空

核心问题 #

更新接口抛出Column 'name' cannot be null异常，本质是数据库列name对应的实体字段firstName在更新时未被正确赋值，触发了数据库的非空约束；删除nullable=false后虽不报错，但因name列为空，导致后续实体无法正常显示。

从Hibernate日志可见，生成的update语句中name=?的参数为null，直接违反了数据库约束。

解决方案 #

1. 确保请求参数与实体字段绑定匹配 #

检查前端提交的更新请求（表单/JSON）：

• 如果是表单提交，需保证输入框的name属性为firstName，与实体字段名一致：

  <input type="text" name="firstName" value="${instructor.firstName}">
  

• 如果是JSON请求，需保证请求体中对应字段为firstName，或给实体字段添加@JsonProperty("name")做映射：

  @Basic
  @Column(name = "name", nullable = false, length = 45)
  @JsonProperty("name")
  private String firstName;
  

2. 规范实体与数据库的字段映射（可选） #

当前实体字段firstName对应数据库name列，命名易混淆。建议开启JPA自动驼峰转下划线命名策略（在application.properties中配置）：

spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.CamelCaseToUnderscoresNamingStrategy

然后修改实体字段映射，去掉手动指定的name属性，让JPA自动映射：

@Basic
@Column(nullable = false, length = 45)
private String firstName;

此时数据库列会自动生成first_name，避免语义混淆。

3. 采用"先查询再覆盖"的更新方式（推荐） #

直接使用save()更新时，若传入的实体字段为null，会覆盖数据库原有值。正确做法是先查询原实体，再覆盖需要更新的字段：

@Override
public Instructor updateInstructor(Instructor instructor) {
    // 查询数据库中已存在的实体
    Instructor existingInstructor = instructorDao.findById(instructor.getInstructorId())
            .orElseThrow(() -> new IllegalArgumentException("未找到该讲师"));
    // 仅覆盖需要更新的字段
    existingInstructor.setFirstName(instructor.getFirstName());
    existingInstructor.setLastName(instructor.getLastName());
    existingInstructor.setInstructorSummary(instructor.getInstructorSummary());
    existingInstructor.setUser(instructor.getUser());
    return instructorDao.save(existingInstructor);
}

这种方式可避免空字段覆盖数据库非空值，同时保证数据完整性。

4. 校验请求参数完整性 #

在Controller中打印传入的实体对象，确认firstName是否为空：

@PostMapping("/update")
public String update(Instructor instructor) {
    System.out.println("接收的讲师数据：" + instructor);
    instructorService.updateInstructor(instructor);
    return "redirect:/instructors/index";
}

若打印结果中firstName为null，说明前端未传递该参数，需修复前端请求逻辑。

额外说明 #

删除nullable=false后实体"不显示"，是因为name列被更新为null，前端视图或查询逻辑过滤了空值数据。解决上述问题后，恢复nullable=false约束即可保证数据库数据的完整性。

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