Spring Boot中PATCH请求实体部分更新及局部Bean校验方案问询

方案1：针对JsonMergePatch实现局部字段校验 #

你的问题核心是校验范围和传入字段不匹配，只需要手动提取PATCH请求传入的字段，仅对这些字段做校验即可，无需触发全实体校验，代码实现如下：

1. 首先注入Validator实例：

@Autowired
private Validator validator;

2. 修改PATCH接口逻辑，提取变更字段后做定向校验：

@PatchMapping(path = "/{id}", consumes = "application/merge-patch+json")
public ResponseEntity<Employee> patchEmployee(@PathVariable Long id, @RequestBody JsonMergePatch jsonMergePatch) throws JsonPatchException, JsonProcessingException {
    Employee existingEmployee = employeeDataService.findById(id)
            .orElseThrow(() -> new ResourceNotFoundException("Employee not exist: id = " + id));
    // 提取PATCH请求携带的所有字段名
    JsonNode patchNode = objectMapper.convertValue(jsonMergePatch, JsonNode.class);
    Set<String> updatedFields = new HashSet<>();
    patchNode.fieldNames().forEachRemaining(updatedFields::add);
    
    // 合并字段得到更新后的实体
    Employee patchedEmployee = applyPatchToEmployee(jsonMergePatch, existingEmployee);
    
    // 仅校验传入的字段
    Set<ConstraintViolation<Employee>> violations = new HashSet<>();
    for (String field : updatedFields) {
        violations.addAll(validator.validateProperty(patchedEmployee, field));
    }
    if (!violations.isEmpty()) {
        throw new ConstraintViolationException(violations);
    }

    return ResponseEntity.ok(employeeDataService.save(patchedEmployee));
}

这种方式可以完美适配你的需求：只有请求中携带的字段会触发校验，未携带的字段哪怕原有值不符合注解规则也不会触发校验。如果用户主动传入了"category": null，也会正常触发@NotNull校验，符合逻辑预期。

其他更易维护的部分更新方案 #

JsonMergePatch虽然灵活，但在业务规则复杂的场景下维护成本较高，推荐两种更稳妥的方案：

方案2：按业务场景拆分专属更新接口 #

如果你的部分更新场景是固定的，比如单独更新教育信息、单独更新基础信息，直接拆分专用接口是成本最低、最易维护的方案：

// 专门更新教育信息的接口
@PutMapping("/{id}/education")
public ResponseEntity<Employee> updateEducation(@PathVariable Long id, @Valid @RequestBody EducationUpdateDTO dto) {
    Employee employee = employeeDataService.findById(id)
            .orElseThrow(() -> new ResourceNotFoundException("Employee not exist: id = " + id));
    employee.setEducation(dto.education());
    employee.setEduName(dto.eduName());
    employee.setEduGraduationDate(dto.eduGraduationDate());
    return ResponseEntity.ok(employeeDataService.save(employee));
}

// 对应DTO定义，直接加所需校验注解
public record EducationUpdateDTO(
    @NotNull Education education,
    @NotBlank String eduName,
    @NotNull LocalDate eduGraduationDate
) {}

这种方案不需要处理复杂的字段合并、动态校验逻辑，接口语义明确，校验规则清晰，非常适合业务场景固定的系统。

方案3：用Optional类型DTO区分「未传值」和「传null」 #

如果确实需要通用的PATCH接口，可以用Optional字段的DTO接收参数，精准识别用户是否传入了对应字段：

// DTO定义，字段上的校验注解仅在用户传入该字段时生效
public record EmployeePatchDTO(
    Optional<@NotNull Category> category,
    Optional<@NotNull Education> education,
    Optional<@NotBlank String> eduName,
    Optional<@NotNull LocalDate> eduGraduationDate
) {}

// 接口实现
@PatchMapping("/{id}")
public ResponseEntity<Employee> patchEmployee(@PathVariable Long id, @Valid @RequestBody EmployeePatchDTO dto) {
    Employee employee = employeeDataService.findById(id)
            .orElseThrow(() -> new ResourceNotFoundException("Employee not exist: id = " + id));
    // 仅赋值用户传入的字段
    dto.category().ifPresent(employee::setCategory);
    dto.education().ifPresent(employee::setEducation);
    dto.eduName().ifPresent(employee::setEduName);
    dto.eduGraduationDate().ifPresent(employee::setEduGraduationDate);
    return ResponseEntity.ok(employeeDataService.save(employee));
}

这种方式可以完全避免JsonMergePatch的序列化、合并问题，同时天然支持局部校验，维护成本比JsonMergePatch低很多。

注意：如果你的Employee实体上的@NotNull注解是JPA层面的数据库约束，需要保证实体持久化前所有字段符合数据库规则，以上局部校验仅保证用户传入字段的合法性，原有字段的合规性建议在实体创建、全量更新的节点做全量校验。

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