Cómo depurar en Java con IntelliJ IDEA: breakpoints, paso a paso y más
Guía práctica para depurar código Java con IntelliJ IDEA: breakpoints condicionales, ejecutar paso a paso, evaluar expresiones, depurar tests y Spring Boot.
En resumen: para depurar en IntelliJ IDEA haz clic en el margen izquierdo de una línea para poner un breakpoint, arranca con Debug (el icono del insecto o
Mayús+F9) y, cuando el programa se pare, avanza con Step Over (F8), entra en métodos con Step Into (F7) y continúa con Resume (F9). En el panel Debugger ves las variables, la pila de llamadas y puedes evaluar expresiones (Alt+F8). Atajos de Windows y Linux; en macOS cambian (indicados abajo).
Depurar es mucho más rápido que llenar el código de System.out.println: paras el programa donde quieres, inspeccionas el estado real y pruebas hipótesis sin volver a compilar.
Vídeo explicativo
El flujo básico
- Pon un breakpoint: clic en el margen junto al número de línea (aparece un punto rojo) o
Ctrl+F8(macOS:Cmd+F8). - Arranca en modo debug: botón del insecto junto a Run, o
Mayús+F9(macOS:Ctrl+D). Si ejecutas con Run, los breakpoints se ignoran. - El programa se detiene en la línea marcada, antes de ejecutarla.
- Inspecciona: el panel Variables muestra los valores actuales; IntelliJ también los pinta en gris al final de cada línea del editor.
- Avanza con los controles de la tabla siguiente.
Controles de ejecución
| Acción | Windows / Linux | macOS | Qué hace |
|---|---|---|---|
| Step Over | F8 | F8 | Ejecuta la línea sin entrar en los métodos que llama |
| Step Into | F7 | F7 | Entra en el método de la línea actual |
| Smart Step Into | Mayús+F7 | Mayús+F7 | Elige en qué método entrar si hay varios en la línea |
| Step Out | Mayús+F8 | Mayús+F8 | Termina el método actual y vuelve a quien lo llamó |
| Run to Cursor | Alt+F9 | Opción+F9 | Continúa hasta la línea del cursor |
| Resume | F9 | Cmd+Opción+R | Continúa hasta el siguiente breakpoint |
| Evaluate Expression | Alt+F8 | Opción+F8 | Ejecuta cualquier expresión con el estado actual |
| Ver breakpoints | Ctrl+Mayús+F8 | Cmd+Mayús+F8 | Lista y configura todos los breakpoints |
Los atajos pueden variar si usas otro mapa de teclado; los tienes en Settings → Keymap.
Técnicas que ahorran horas
Breakpoints condicionales
Clic derecho sobre el punto rojo y escribe una condición, por ejemplo pedido.getId().equals("A-101") o i == 500. El programa solo se para cuando se cumple: imprescindible dentro de bucles.
Breakpoints que no paran (logging)
En el mismo menú, desmarca Suspend y activa Evaluate and log: IntelliJ imprime una expresión cada vez que pasa por ahí, sin tocar el código ni recompilar.
Breakpoints de excepción
En View Breakpoints (Ctrl+Mayús+F8), añade un Java Exception Breakpoint para, por ejemplo, NullPointerException. El depurador se para en la línea exacta donde se lanza, aunque la excepción se capture más arriba.
Evaluar y cambiar valores
Con Alt+F8 puedes llamar a métodos (lista.stream().filter(...).count()) con el estado real. En el panel Variables, clic derecho → Set Value para cambiar un valor y probar otro camino sin reiniciar.
Frames y Drop Frame
El panel Frames muestra la pila de llamadas: clic en un nivel anterior para ver sus variables. Reset Frame (antes Drop Frame) vuelve al inicio del método actual para repetirlo, con la precaución de que los efectos ya producidos (escrituras en base de datos, por ejemplo) no se deshacen.
Streams
Con el programa parado en una línea con un stream, el botón Trace Current Stream Chain muestra qué elementos pasan por cada filter y map. Muy útil con las operaciones de streams en Java.
Depurar tests y Spring Boot
- Tests: clic en el icono verde junto al test → Debug. Es la forma más rápida de reproducir un fallo con datos controlados; tienes cómo escribirlos en JUnit 5.
- Spring Boot desde el IDE: arranca la clase con
mainen modo debug y lanza la petición HTTP desde el navegador,curlo el cliente HTTP de IntelliJ; se parará en tu controlador. - Aplicación que ya está corriendo (otro proceso, Docker, un servidor): arráncala con
java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar app.jary en IntelliJ crea una configuración Remote JVM Debug al puerto 5005. Nunca dejes ese puerto abierto en producción.
Errores frecuentes
- Arrancar con Run en lugar de Debug y esperar a que se pare.
- El código no coincide con lo que se ejecuta: si el breakpoint aparece con un aspa, el código compilado es distinto del fuente. Recompila (
Ctrl+F9). - Evaluar expresiones con efectos:
Alt+F8sobreiterator.next()consume un elemento de verdad. - Breakpoints en código muy concurrente: parar un hilo cambia los tiempos y puede ocultar el error. Usa breakpoints que solo registran o configura Suspend: Thread en vez de All.
Preguntas frecuentes
¿Funciona igual en la edición gratuita de IntelliJ?
Sí, el depurador de Java está completo en la versión gratuita. La depuración específica de algunos frameworks es exclusiva de la de pago.
¿Y en VS Code o Eclipse?
Los conceptos son idénticos (breakpoints, step over/into/out, evaluar expresiones); cambian los atajos.
¿Cómo depuro un NullPointerException?
Lee primero el mensaje: desde Java 14 indica qué variable era null. Después pon un breakpoint de excepción para parar justo donde ocurre. Para evitarlo de raíz, tienes @Nullable y @NonNull y Optional.
Sigue aprendiendo
Instalar el JDK, configurar IntelliJ y depurar tus primeros programas forma parte del curso de Java desde cero. Si trabajas con varios proyectos a la vez, tienes cómo abrir múltiples proyectos en IntelliJ.
Newsletter Semanal de Java
Cada viernes recibe lo más nuevo del ecosistema Java: frameworks, herramientas y mejores prácticas.
Sin spam. Cancela cuando quieras.