document设为主键后重复POST未返回BAD_REQUEST问题求助

云原生阿岚

2026-8-22

问题原因

你遇到的情况是因为Spring Data JPA的save()方法默认逻辑：当传入的实体主键（这里是document）在数据库中已存在时，会执行更新操作；只有主键不存在时才会执行插入。所以即便你加了唯一约束，只要主键已存在，save就会触发update语句，不会触发数据库的唯一键冲突。

解决方案

要实现重复document时返回BAD_REQUEST，需要在业务层主动校验，步骤如下：

步骤1：自定义异常类
用来标记重复document的错误：

public class DuplicateDocumentException extends RuntimeException {
    public DuplicateDocumentException(String message) {
        super(message);
    }
}

步骤2：在Service层添加校验逻辑
调用Repository的existsById()方法判断document是否已存在，存在则抛异常：

@Service
public class ClienteService {

    private final ClienteRepository clienteRepository;

    public ClienteService(ClienteRepository clienteRepository) {
        this.clienteRepository = clienteRepository;
    }

    public Cliente saveCliente(Cliente cliente) {
        if (clienteRepository.existsById(cliente.getDocument())) {
            throw new DuplicateDocumentException("Document " + cliente.getDocument() + " already exists");
        }
        return clienteRepository.save(cliente);
    }
}

步骤3：全局异常处理器返回400状态码
捕获自定义异常，返回BAD_REQUEST响应：

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(DuplicateDocumentException.class)
    public ResponseEntity<String> handleDuplicateDocument(DuplicateDocumentException ex) {
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(ex.getMessage());
    }
}