Qué es debug y qué significa debugging en programación

El formulario funcionaba ayer. Hoy pulsas el botón, aparece el mensaje de enviado y el correo no llega a ninguna parte. Nadie recuerda haber cambiado nada, el servidor sigue encendido y, aparentemente, todo está en su sitio. Es justo en ese momento cuando empieza el debug.

En español solemos hablar de depurar código. No consiste únicamente en hacer desaparecer un mensaje de error. Hay que reproducir el problema, localizar su causa, corregirla y comprobar que el arreglo no ha roto otra parte del sistema.

Qué significa debug y en qué se diferencia de bug o debugger

Estos términos suelen aparecer juntos y es fácil mezclarlos, especialmente cuando uno se encuentra por primera vez con un mensaje técnico, una consola llena de avisos o una opción llamada “modo debug”.

Concepto	Qué significa
Bug	Error, defecto o comportamiento inesperado de un programa.
Debug	Acción de buscar, analizar y corregir el error.
Debugging	Nombre en inglés del proceso de depuración.
Debugger	Herramienta que ayuda a detener y revisar la ejecución del código.
Depurar	Localizar la causa de un fallo, corregirla y comprobar el resultado.

Un bug no tiene por qué provocar una pantalla llena de errores. A veces el programa sigue funcionando, pero devuelve un cálculo incorrecto, guarda un dato donde no debe o ejecuta una acción diferente a la esperada.

También puede ocurrir que el fallo solo aparezca bajo ciertas condiciones. Por ejemplo, al utilizar un navegador concreto, al llegar a determinado número de usuarios, al recibir un valor vacío o al actualizar una versión de PHP.

De dónde vienen los términos bug y debug

La historia más conocida ocurrió en 1947, cuando un equipo que trabajaba con el ordenador Harvard Mark II encontró una polilla atrapada en uno de sus relés. El insecto fue pegado en el cuaderno de registro junto a una anotación sobre el primer caso real de un “bug” encontrado en el sistema.

La anécdota ayudó a popularizar el término, aunque la palabra bug ya se utilizaba antes para hablar de fallos técnicos. El cuaderno original se conserva en el Museo Nacional de Historia Americana.

Es una historia curiosa, pero hoy la mayoría de los bugs no tienen alas ni se pueden sacar con unas pinzas. Suelen esconderse entre líneas de código, datos, configuraciones, servicios externos y situaciones que nadie había previsto.

Cómo funciona un proceso de debugging

Depurar un programa no consiste en cambiar cosas hasta que deje de fallar. Un proceso ordenado intenta reducir el problema poco a poco para llegar a su origen sin crear otros errores por el camino.

1. Reproducir el fallo. Hay que saber qué ocurre, cuándo aparece y qué pasos permiten provocarlo de nuevo.
2. Recoger información. Se revisan mensajes de error, logs, datos recibidos, versiones y cambios recientes.
3. Acotar el problema. Se intenta descubrir qué módulo, función, archivo, petición o configuración está implicado.
4. Seguir la ejecución. Se inspeccionan variables, condiciones, llamadas y decisiones tomadas por el programa.
5. Encontrar la causa. El lugar donde se ve el error no siempre es el lugar donde empezó.
6. Aplicar la corrección. Se modifica el código o la configuración responsable del fallo.
7. Volver a probar. Se comprueba que el problema ha desaparecido.
8. Revisar el resto. Un arreglo puede resolver una función y romper otra que dependía de ella.

Un botón puede dejar de responder en el navegador, pero el origen estar en una petición JavaScript, una API externa, un permiso del servidor o un dato incorrecto enviado desde la base de datos.

Por eso el debugging suele parecerse más a seguir un rastro que a pulsar un botón mágico. La primera pista ayuda, pero todavía hay que averiguar de dónde viene.

Tipos de errores que se pueden depurar

No todos los fallos son iguales. Saber ante qué tipo de error estamos ayuda a decidir dónde mirar primero.

Tipo de error	Ejemplo	Qué sucede
Error de sintaxis	Falta un paréntesis o una comilla.	El código no puede interpretarse o ejecutarse correctamente.
Error de ejecución	Se intenta utilizar una función o un dato que no existe.	El programa se detiene o muestra un error durante su uso.
Error lógico	Una condición excluye a quien tiene exactamente 18 años.	El programa funciona, pero el resultado no es el esperado.
Error de entorno	El código funciona con una versión de PHP y falla con otra.	El problema depende del servidor, las versiones o la configuración.
Error de integración	Una API, una pasarela de pago o un servicio de correo deja de responder.	Dos sistemas que necesitan comunicarse dejan de hacerlo correctamente.

Los errores lógicos suelen dar más guerra que los de sintaxis. Un error de sintaxis normalmente hace ruido. El fallo lógico puede quedarse meses trabajando en silencio y entregando resultados incorrectos con total tranquilidad.

Qué herramientas se utilizan para depurar código

La herramienta concreta depende del lenguaje de programación, del entorno y del tipo de problema. Aun así, muchas técnicas de depuración se repiten.

Mensajes y logs de errores

Un mensaje de error informa de que algo ha fallado. Puede mostrar el tipo de problema, el archivo afectado y la línea donde se ha detectado.

Un log de errores registra lo que estaba ocurriendo en el sistema. Puede guardar peticiones, respuestas, avisos, valores, fechas y sucesos anteriores al fallo. En problemas que aparecen de forma intermitente, estos registros suelen ser mucho más útiles que mirar la pantalla esperando que el error vuelva a salir.

Puntos de interrupción o breakpoints

Un breakpoint es un punto en el que detenemos voluntariamente la ejecución del programa. Al quedar pausado, podemos revisar el valor de las variables, comprobar qué función se está ejecutando y avanzar línea por línea.

También existen puntos de interrupción condicionales. En lugar de detener siempre el código, pueden activarse únicamente cuando se cumple una condición concreta. Esto resulta útil cuando el fallo solo aparece con un usuario, un valor o una situación determinada.

Inspección de variables y pila de llamadas

Las variables almacenan los datos con los que está trabajando el programa. Inspeccionarlas ayuda a comprobar si contienen lo que esperábamos o si el error comenzó cuando un valor llegó vacío, duplicado o con un formato incorrecto.

La pila de llamadas muestra el recorrido de funciones que ha llevado hasta el punto actual. Dicho de forma sencilla, nos ayuda a reconstruir el camino que ha seguido el programa antes de llegar al error.

Pruebas unitarias y control de versiones

Las pruebas unitarias comprueban pequeñas partes del código de forma aislada. No sustituyen al debugging, pero ayudan a detectar rápidamente si una modificación ha roto un comportamiento que antes funcionaba.

El control de versiones permite revisar qué se cambió, comparar archivos y recuperar estados anteriores. Cuando un problema aparece justo después de una modificación, este historial puede ahorrar bastante tiempo.

Debug en páginas web

Los navegadores actuales incluyen herramientas para revisar HTML, CSS, JavaScript, almacenamiento, rendimiento y peticiones de red. Chrome DevTools, Firefox Developer Tools y el inspector de Safari son algunos ejemplos.

Desde estas herramientas podemos comprobar si un archivo no se ha cargado, si una petición devuelve un error, si JavaScript se detiene, si una regla CSS está siendo sustituida o si la respuesta de una API no contiene los datos esperados.

También se pueden establecer breakpoints, avanzar paso a paso por el código y consultar los valores de las variables mientras la página se está ejecutando.

Qué es el modo debug en WordPress

WordPress incorpora un sistema de depuración que puede mostrar o registrar avisos, errores y mensajes relacionados con PHP, plugins, temas y funciones utilizadas de forma incorrecta.

La constante principal es WP_DEBUG. Al activarla, WordPress comienza a recoger información que puede ayudar a localizar el origen de una pantalla blanca, un error crítico o una funcionalidad que ha dejado de responder.

WP_DEBUG_LOG puede guardar esos mensajes en un archivo de registro, mientras que WP_DEBUG_DISPLAY controla si se muestran directamente en pantalla.

La documentación oficial de depuración de WordPress recomienda utilizar estas herramientas en entornos de desarrollo o pruebas, no dejarlas activadas sin control en una web pública.

El modo debug puede mostrar una pista, pero no repara la web por sí solo. Para resolver el problema hay que interpretar el mensaje, localizar su causa y decidir si corresponde corregir código, desactivar una extensión, restaurar una copia o revisar el servidor.

Cuando una web muestra errores PHP, una pantalla blanca o ha dejado de funcionar tras una actualización, conviene revisar y reparar la web antes de cambiar archivos y plugins al azar.

Ejemplo práctico: un formulario dice enviado, pero el correo no llega

Imagina que un formulario de contacto muestra el mensaje “enviado correctamente”, pero la empresa no recibe ningún correo.

El síntoma aparece en el formulario, pero la causa puede encontrarse en lugares muy distintos:

• la dirección de destino está mal escrita;
• el plugin no está generando el envío;
• el servidor bloquea la función de correo;
• la configuración SMTP ha dejado de autenticar;
• los registros SPF o DKIM no son correctos;
• el mensaje llega, pero termina en la carpeta de correo no deseado.

Un proceso de debugging razonable empezaría reproduciendo el envío. Después revisaría la consola del navegador y la petición generada por el formulario. Si ambas funcionan, tocaría comprobar los logs de WordPress, del servidor o del servicio SMTP.

Una vez localizada la causa, se aplicaría la corrección y se repetirían varias pruebas desde direcciones y dispositivos diferentes.

Errores habituales al hacer debugging

Depurar con prisas puede convertir una incidencia sencilla en una tarde bastante larga. Estos son algunos errores que conviene evitar:

• Cambiar varias cosas a la vez. Si el problema desaparece, no sabremos qué cambio lo corrigió.
• No reproducir el fallo. Sin conocer los pasos exactos es difícil comprobar si la reparación ha funcionado.
• Trabajar sin una copia. Un cambio mal hecho puede dejar el sistema peor que al principio.
• Ignorar los logs. Muchas veces la pista ya está escrita, pero nadie se ha detenido a leerla.
• Confundir el síntoma con la causa. El archivo que muestra el error no siempre es quien lo provoca.
• No probar casos relacionados. Una corrección puede funcionar en una situación y fallar en otras.
• Dejar el modo debug activo. En una web pública puede mostrar información o generar archivos enormes.
• Dar por culpable al último cambio. Puede serlo, pero también puede haber destapado un problema anterior.

Depurar, probar, reparar y mantener no son lo mismo

Acción	Objetivo
Depurar	Localizar y entender la causa de un error.
Probar	Comprobar si el resultado coincide con lo esperado.
Reparar	Aplicar los cambios necesarios para recuperar el funcionamiento.
Mantener	Revisar, actualizar y cuidar el sistema para reducir problemas futuros.

Una reparación resuelve una incidencia concreta. El mantenimiento de WordPress busca evitar que plugins, temas, copias, seguridad y versiones se queden abandonados hasta que algo se rompa.

Cuándo conviene pedir ayuda para depurar un error

No todos los bugs necesitan un equipo técnico. Un error pequeño en un proyecto de pruebas puede servir incluso para aprender. La cosa cambia cuando el problema afecta a una web publicada, pedidos, formularios, datos o usuarios reales.

Conviene dejar de hacer pruebas a ciegas cuando:

• la web está caída o muestra un error crítico;
• el fallo afecta a ventas, reservas o contactos;
• no existe una copia reciente;
• hay datos personales o información sensible;
• el problema comenzó después de una actualización;
• los cambios realizados están empeorando la situación;
• la incidencia afecta al servidor o a la base de datos;
• no se puede reproducir el error de forma segura.

Preguntas frecuentes sobre debug y debugging

¿Qué significa debug?

Debug significa localizar, analizar y corregir errores en un programa, una aplicación o un sistema. En español se suele traducir como depuración.

¿Qué es debugging en programación?

Debugging es el proceso de investigar por qué un programa no se comporta como debería, encontrar la causa del fallo, corregirla y volver a probar el resultado.

¿Cuál es la diferencia entre bug y debug?

Un bug es el error o comportamiento inesperado. Debug es el proceso utilizado para encontrar y corregir ese error.

¿Qué es un debugger?

Un debugger es una herramienta que permite detener la ejecución de un programa, avanzar paso a paso, inspeccionar variables y revisar el recorrido seguido por el código.

¿Qué significa depurar un programa?

Depurar un programa significa localizar errores en su código o funcionamiento, comprender su causa, corregirlos y comprobar que el sistema vuelve a responder correctamente.

¿Qué es un breakpoint?

Un breakpoint o punto de interrupción es una marca que detiene temporalmente la ejecución del código para poder revisar variables, funciones y condiciones en ese momento.

¿Para qué sirven los logs de errores?

Los logs guardan información sobre lo que ocurre dentro de un sistema. Ayudan a reconstruir los pasos anteriores a un fallo y a encontrar errores que no siempre aparecen en pantalla.

¿Es seguro activar el modo debug en WordPress?

Puede utilizarse para localizar errores, pero no conviene dejarlo activo sin control en una web pública. Los mensajes o archivos de registro podrían mostrar información técnica sensible.