Как в Spring Boot 3 возвращать ошибки REST API в едином формате?

Централизация. Класс с @RestControllerAdvice содержит методы @ExceptionHandler(OrderNotFoundException.class) и применяется ко всем контроллерам: маппинг исключений на HTTP-ответы в одном месте, без try/catch в каждом методе.

Единый формат — ProblemDetail. RFC 9457 (ранее 7807) описывает тело ошибки: type (URI типа проблемы), title, status, detail, instance и расширения. Spring Framework 6 добавил класс ProblemDetail и интерфейс ErrorResponse; ResponseEntityExceptionHandler можно расширить, чтобы стандартные исключения MVC (неверный JSON, неподдерживаемый метод, ошибки валидации) тоже возвращались в этом формате. В Spring Boot — spring.mvc.problemdetails.enabled=true.

Что отдавать:

• правильный статус: 400 — неверный запрос, 404 — нет ресурса, 409 — конфликт состояния, 422 — бизнес-валидация, 500 — неожиданная ошибка;
• машинный код ошибки (type или своё поле code) для клиентов;
• ошибки полей валидации списком;
• trace/correlation id для поддержки;
• никаких стектрейсов и SQL — их в лог.

@RestControllerAdvice
class ApiErrors {
    @ExceptionHandler(OrderNotFoundException.class)
    ProblemDetail notFound(OrderNotFoundException e) {
        ProblemDetail pd = ProblemDetail.forStatusAndDetail(HttpStatus.NOT_FOUND, e.getMessage());
        pd.setType(URI.create("https://api.shop.ru/errors/order-not-found"));
        pd.setProperty("orderId", e.orderId());
        return pd;
    }
}