Iniciar sesión

Excepciones con código de estado en Spring Boot

@ResponseStatus, ResponseStatusException y @ExceptionHandler

Unidad: Validación y manejo de errores Gratis
🚨
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.*).

Pon a prueba lo que aprendiste

Trazar código

Nadie maneja PedidoNoEncontrado. Haces GET /pedidos/9, que no existe. ¿Qué responde?

class PedidoNoEncontrado extends RuntimeException { PedidoNoEncontrado(int id) { super("No existe el pedido " + id); } } @RestController @RequestMapping("/pedidos") class PedidosController { @GetMapping("/{id}") String uno(@PathVariable int id) { String p = pedidos.get(id); if (p == null) throw new PedidoNoEncontrado(id); return p; } }
  1. A404 Not Found (no existe)
  2. B200 OK, sin ningún cuerpo
  3. C400 Bad Request (id malo)
  4. D500 Internal Server Error
Ver respuesta
D) 500 Internal Server Error Una excepción sin manejar es un 500.
Concepto

¿Por qué responder 500 a GET /pedidos/9, cuando el pedido 9 no existe, es una mala respuesta?

  1. ADice que falló el servidor, y fue un id inexistente
  2. BPorque 500 hace que la app se reinicie sola
  3. CPorque el 500 no se puede mandar en una API REST
  4. DPorque el cliente ya no puede volver a pedir nada
Ver respuesta
A) Dice que falló el servidor, y fue un id inexistente El código debe decir de quién es el error.
Trazar código

No hay más configuración. Haces GET /pedidos/9. ¿Qué responde?

@GetMapping("/pedidos/{id}") String uno(@PathVariable int id) { throw new ResponseStatusException( HttpStatus.NOT_FOUND, "No existe ese pedido"); }
  1. A500 porque se lanzó una excepción
  2. B200 con el texto No existe ese pedido
  3. C404 y el JSON de error, sin tu mensaje
  4. D404 y el JSON de error, con tu mensaje
Ver respuesta
C) 404 y el JSON de error, sin tu mensaje El código es 404, pero el mensaje no sale.

Practica esta lección completa

Ejercicios de completar código, ordenar bloques y respuesta libre. Ganas XP y mantienes tu racha.

Practicar gratis, sin registrarte Entras como invitado directo a esta lección. Sin tarjeta.