Spring Boot创建REST接口报DataIntegrityViolationException错误求助

核心错误原因 #

报错信息明确指出：Employee.firstName 是非空属性，但传入的值为null或者瞬态值，违反了数据完整性约束。以下是逐一排查方向：

1. 检查实体类Employee的字段配置 #

• 确认firstName字段是否标记了非空约束，比如@NotNull或@Column(nullable = false)：

  @Entity
  @Table(name = "employees")
  public class Employee {
      @Id
      @GeneratedValue(strategy = GenerationType.IDENTITY)
      private Long id;
  
      @NotNull // 确保该注解存在，对应数据库的非空约束
      @Column(name = "first_name") // 如果数据库列名是下划线格式，需指定对应关系
      private String firstName;
  
      // 务必确保该字段有正确的getter和setter方法
      public String getFirstName() {
          return firstName;
      }
  
      public void setFirstName(String firstName) {
          this.firstName = firstName;
      }
  
      // 其他字段、构造方法...
  }
  

• 缺少getter/setter会导致Spring MVC无法正确绑定请求参数，最终字段为null。

2. 验证Postman请求的正确性 #

• 请求体格式与字段名：确保JSON请求体中包含firstName字段，且字段名与实体类属性完全一致（大小写敏感）：

  {
      "firstName": "张三",
      "lastName": "李四",
      "email": "zhangsan@example.com"
  }
  

• Content-Type设置：请求头必须设置Content-Type: application/json，否则Spring无法解析JSON格式的请求体。
• 请求方式：确认是POST请求，路径为/api/employees。

3. 检查Controller的POST方法 #

• 必须在方法参数上添加@RequestBody注解，否则Spring会将请求参数解析为URL参数，而非请求体中的JSON：

  @RestController
  @RequestMapping("/api")
  public class EmployeeController {
      @Autowired
      private EmployeeService employeeService;
  
      @PostMapping("/employees")
      public ResponseEntity<Employee> createEmployee(@RequestBody Employee employee) {
          Employee savedEmployee = employeeService.saveEmployee(employee);
          return new ResponseEntity<>(savedEmployee, HttpStatus.CREATED);
      }
  }
  

• 遗漏@RequestBody是新手最常见的错误之一，会导致Employee对象的所有属性为null，触发非空约束报错。

4. 核对数据库表结构 #

• 确认MySQL表中的first_name（或对应字段）设置了NOT NULL约束，建表语句示例：

  CREATE TABLE employees (
      id INT AUTO_INCREMENT PRIMARY KEY,
      first_name VARCHAR(50) NOT NULL,
      last_name VARCHAR(50) NOT NULL,
      email VARCHAR(100) NOT NULL UNIQUE
  );
  

• 如果实体类字段名与数据库列名不匹配（比如实体类是firstName，数据库是first_name），需确保Spring Boot的命名策略自动转换驼峰为下划线（默认开启），或通过@Column注解手动指定对应关系。

5. 排查Service层的保存逻辑 #

• 检查EmployeeServiceImpl的saveEmployee方法，确保没有修改传入的Employee对象，导致firstName被设为null：

  @Service
  public class EmployeeServiceImpl implements EmployeeService {
      @Autowired
      private EmployeeRepository employeeRepository;
  
      @Override
      public Employee saveEmployee(Employee employee) {
          // 不要在此处修改employee的firstName属性
          return employeeRepository.save(employee);
      }
  }
  

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