Sigue la evidencia
- Anota qué esperabas y qué pasó: URL, entrada y pasos de reproducción.
- Divide el recorrido: navegador → API → lógica → base/servicio externo → infraestructura.
- Busca el primer error relevante y el primer
Caused bydel stack trace. - Reproduce con datos no sensibles y cambia una hipótesis a la vez.
- Usa breakpoints, variables y call stack. En frontend, revisa Console y Network.
- Comprueba el caso afectado y los comportamientos cercanos.
Mensaje y primera pista
| Mensaje | Primera hipótesis |
|---|---|
UnsupportedClassVersionError |
El JDK no entiende el bytecode compilado. |
Address already in use |
El puerto ya está ocupado o la app corre dos veces. |
Connection refused |
Host/puerto incorrecto o servicio detenido. |
401 / 403 |
Autenticación / autorización. |
404 |
Ruta, recurso o base path incorrectos. |
500 |
Correlaciona la petición con logs del servidor. |
Logs que ayudan
log.info("orderId={}", orderId);Usa DEBUG para diagnóstico, INFO para eventos normales, WARN para anomalías y ERROR para fallos que requieren atención. No registres tokens, contraseñas, headers de autorización ni datos personales.