Excepciones con código de estado
Cuando alguien pide un pedido que no existe, lo natural es lanzar una excepción propia. Pero si nadie dice qué código usar, Spring responde 500, como si se hubiera caído el servidor, aunque el error fue de quien pidió.
class PedidoNoEncontrado extends RuntimeException {
PedidoNoEncontrado(int id) {
super("No existe el pedido " + id);
}
}
Hay tres formas comunes de elegir el código. La más simple:
@ResponseStatus sobre la clase de la excepción, y cada vez que se lance, Spring responde ese código.@ResponseStatus(HttpStatus.NOT_FOUND)
class PedidoNoEncontrado extends RuntimeException {
Sin crear una clase: lanzar
ResponseStatusException con el código y un mensaje.throw new ResponseStatusException(
HttpStatus.NOT_FOUND, "No existe ese pedido");
Es cómoda, pero mete HTTP en tu código: úsala en el controlador; en un servicio, mejor una excepción propia.
Y para armar tú la respuesta: un método con
@ExceptionHandler en el controlador, que recibe la excepción.@ExceptionHandler(PedidoNoEncontrado.class)
ResponseEntity<String> noExiste(PedidoNoEncontrado e) {
return ResponseEntity.status(404)
.body(e.getMessage());
}
Por seguridad, el JSON de error de Spring Boot no incluye el mensaje de la excepción, porque podría revelar detalles internos. Para verlo mientras pruebas:
spring.web.error.include-message=always (en Spring Boot 4; antes era server.error.*).