JPA PUT请求遇重复邮箱未返回409却返回500错误排查

开发的患者数据库系统中，新增（POST）重复邮箱的患者能正常返回409 Conflict，但更新（PUT）时触发邮箱冲突，控制台已抛出UniqueFieldViolation异常，Postman却收到500 Internal Server Error。以下是具体排查和修复方案：

1. 检查异常类的状态码注解配置 #

POST请求中抛出的EmailAlreadyUsed异常应该通过@ResponseStatus注解绑定了409状态码，而PUT中使用的UniqueFieldViolation大概率缺少该配置，导致Spring默认将其映射为500错误。

给UniqueFieldViolation类添加状态码注解：

import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ResponseStatus;

@ResponseStatus(HttpStatus.CONFLICT) // 明确绑定409状态码
public class UniqueFieldViolation extends RuntimeException {
    public UniqueFieldViolation(String message) {
        super(message);
    }
}

2. 检查全局异常处理器（若使用） #

如果项目通过@ControllerAdvice实现全局异常处理，需确认是否对UniqueFieldViolation做了专门处理，否则未被捕获的异常会返回500。

补充全局异常处理逻辑：

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;

@ControllerAdvice
public class GlobalExceptionHandler {

    // 处理邮箱冲突类异常
    @ExceptionHandler(UniqueFieldViolation.class)
    public ResponseEntity<String> handleUniqueFieldViolation(UniqueFieldViolation ex) {
        return new ResponseEntity<>(ex.getMessage(), HttpStatus.CONFLICT);
    }

    // 保留其他已有的异常处理逻辑...
}

3. 优化PUT方法的代码逻辑（可选） #

原PUT方法的try-catch块范围过大，可简化逻辑让异常抛出更直接，同时避免变量作用域带来的潜在问题：

public Patient updatePatientById(Long id, Patient patient) {
    // 校验路径ID与请求体ID一致性
    if (!patient.getId().equals(id)){
        throw new BadDataResponse(StringConstants.BAD_REQUEST_ID);
    }

    // 直接获取患者，不存在则抛出404
    Patient existingPatient = patientRepository.findById(id)
            .orElseThrow(() -> new ResourceNotFound(StringConstants.BAD_REQUEST_PATIENT));

    String currentEmail = existingPatient.getEmail();
    String newEmail = patient.getEmail();

    boolean emailIsSame = currentEmail.equals(newEmail);
    boolean newEmailIsUnique = !patientRepository.existsByEmail(newEmail);

    if (emailIsSame || newEmailIsUnique) {
        return patientRepository.save(patient);
    }

    // 邮箱冲突，抛出绑定409的异常
    throw new UniqueFieldViolation(StringConstants.EMAIL_CONFLICT);
}

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