ProblemDetail: errores estándar
Si cada API inventa su forma de error, cada cliente tiene que aprender una distinta. ProblemDetail es el formato estándar para responder errores, definido en el RFC 9457 (el documento oficial de internet que lo describe; reemplazó al RFC 7807), con campos fijos:
title resumen corto, como "Not Found"
status el código, como 404
detail qué pasó en este caso
instance la ruta que falló
type enlace a la explicación (opcional)
En Spring, tu manejador puede devolver un
ProblemDetail. Spring llena instance con la ruta y responde con Content-Type: application/problem+json.@ExceptionHandler(PedidoNoEncontrado.class)
ProblemDetail noExiste(PedidoNoEncontrado e) {
return ProblemDetail.forStatusAndDetail(
HttpStatus.NOT_FOUND, e.getMessage());
}
// GET /pedidos/9 → 404
// {"detail":"No existe el pedido 9",
// "instance":"/pedidos/9","status":404,
// "title":"Not Found"}
Con
setTitle cambias el título, y con setProperty agregas campos tuyos, como la lista de errores de validación:pd.setTitle("Pedido inválido");
pd.setProperty("errores", lista);
Y si en application.properties pones
spring.mvc.problemdetails.enabled=true, los errores de Spring también salen así: la validación fallida, una ruta que no existe o un ResponseStatusException. Ojo: en la validación el detail es genérico y en inglés («Invalid request content.»), sin decir qué campo falló; para eso sigues necesitando tu manejador.