Artículo

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

  1. Pon un breakpoint: clic en el margen junto al número de línea (aparece un punto rojo) o Ctrl+F8 (macOS: Cmd+F8).
  2. 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.
  3. El programa se detiene en la línea marcada, antes de ejecutarla.
  4. Inspecciona: el panel Variables muestra los valores actuales; IntelliJ también los pinta en gris al final de cada línea del editor.
  5. Avanza con los controles de la tabla siguiente.

Controles de ejecución

AcciónWindows / LinuxmacOSQué hace
Step OverF8F8Ejecuta la línea sin entrar en los métodos que llama
Step IntoF7F7Entra en el método de la línea actual
Smart Step IntoMayús+F7Mayús+F7Elige en qué método entrar si hay varios en la línea
Step OutMayús+F8Mayús+F8Termina el método actual y vuelve a quien lo llamó
Run to CursorAlt+F9Opción+F9Continúa hasta la línea del cursor
ResumeF9Cmd+Opción+RContinúa hasta el siguiente breakpoint
Evaluate ExpressionAlt+F8Opción+F8Ejecuta cualquier expresión con el estado actual
Ver breakpointsCtrl+Mayús+F8Cmd+Mayús+F8Lista 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 main en modo debug y lanza la petición HTTP desde el navegador, curl o 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.jar y 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+F8 sobre iterator.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.

debug depurar intellij idea java breakpoints depuración

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.

Compartir artículo