Activar modo debug en WordPress: Ver errores en pantalla y log

¿Qué es el modo debug de WordPress y por qué te interesa?

Si alguna vez has visto una página en blanco en tu web, un error que no sabes de dónde viene o un plugin que no funciona como debería, probablemente necesitas activar el modo debug de WordPress. Este modo es una herramienta de diagnóstico que muestra los errores internos del sistema, algo así como abrir el capó de tu coche para ver qué falla.

Cuando el modo debug está desactivado, WordPress oculta los errores para que los visitantes no vean mensajes extraños. Pero cuando lo activas, el sistema te muestra exactamente qué archivo está fallando, en qué línea y con qué mensaje. Esto es oro puro para solucionar problemas de forma rápida.

A lo largo de este artículo te voy a explicar paso a paso cómo activar el modo debug wordpress, qué significan cada una de las constantes que necesitas configurar y cómo interpretar los errores que aparecen. No necesitas ser un experto en programación, solo seguir las instrucciones con calma.

¿Qué necesitas antes de empezar?

Antes de tocar nada, asegúrate de tener lo siguiente:

Acceso al panel de control de tu hosting o al administrador de archivos.
Un editor de texto plano como el Bloc de notas, Visual Studio Code o Sublime Text.
Una copia de seguridad reciente de tu archivo wp-config.php, porque vamos a modificarlo.
Paciencia y un café, porque vamos a hacerlo bien.

Si tu hosting utiliza un panel como Syspanel, recuerda que puedes acceder al administrador de archivos desde el puerto 2106. Simplemente inicia sesión en Syspanel, busca la opción de "Administrador de archivos" y navega hasta la carpeta donde tienes instalado WordPress.

Paso 1: Localiza el archivo wp-config.php

El archivo más importante para activar el debug wordpress es el wp-config.php. Este archivo se encuentra en la raíz de tu instalación de WordPress, normalmente en la misma carpeta donde están las carpetas wp-content, wp-admin y wp-includes.

Para localizarlo, tienes dos opciones:

A través del administrador de archivos de tu hosting.
A través de un cliente FTP como FileZilla.

Una vez que lo encuentres, descarga una copia de seguridad a tu ordenador. Esto es importante porque si algo sale mal, puedes restaurar la versión original.

Paso 2: Abre el archivo en un editor de texto

Ahora abre el wp-config.php con tu editor de texto. Verás muchas líneas de código PHP. No te asustes, no necesitas entenderlo todo. Solo vamos a buscar una sección concreta.

Dentro del archivo, busca una línea que diga algo como:

define('WP_DEBUG', false);

Esta línea suele estar cerca del final del archivo, justo antes de la línea que dice "Eso es todo, ¡deja de editar!". Si no encuentras esta línea, no te preocupes, la añadiremos nosotros.

Paso 3: Activa el modo debug wordpress

Para activar el modo debug wordpress, cambia el valor de false a true en la línea de WP_DEBUG. Es decir, la línea quedará así:

define('WP_DEBUG', true);

Si no existía la línea, puedes añadirla justo antes de la línea de "Eso es todo". Simplemente copia y pega el código anterior.

Guarda el archivo y súbelo de nuevo si lo estabas editando localmente.

Paso 4: Configura las constantes adicionales (opcional pero muy útil)

Activar solo WP_DEBUG mostrará los errores en pantalla, pero hay dos constantes más que te recomiendo configurar para tener un diagnóstico completo:

WP_DEBUG_LOG

Esta constante guarda los errores en un archivo de log en lugar de mostrarlos en pantalla. Esto es muy útil si no quieres que los visitantes vean los errores mientras estás trabajando.

Para activarla, añade esta línea justo debajo de WP_DEBUG:

define('WP_DEBUG_LOG', true);

Los errores se guardarán en un archivo llamado debug.log dentro de la carpeta wp-content.

WP_DEBUG_DISPLAY

Esta constante controla si los errores se muestran en pantalla o no. Si la pones en false, los errores solo se guardarán en el log, no se mostrarán en la web.

Para desactivar la visualización en pantalla, añade:

define('WP_DEBUG_DISPLAY', false);

Y si quieres que se muestren en pantalla (por ejemplo, durante el desarrollo), ponla en true.

Configuración recomendada para principiantes

Si estás empezando, te recomiendo esta configuración:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', true);

Así verás los errores en pantalla y también se guardarán en el log para consultarlos después.

[INFO] Si tu web da error 500 después de activar el modo debug, no entres en pánico. Simplemente vuelve a poner WP_DEBUG en false y restaura tu copia de seguridad si es necesario.

Paso 5: Guarda los cambios y comprueba los errores

Una vez que hayas añadido las líneas, guarda el archivo wp-config.php y súbelo a tu servidor si lo estabas editando localmente.

Ahora visita tu web. Si hay errores, verás mensajes como "Warning", "Notice" o "Fatal error" seguidos de la ruta del archivo y el número de línea donde se produce el problema.

Por ejemplo, un error típico puede verse así:

Warning: Undefined array key "name" in /home/public_html/wp-content/themes/mi-tema/functions.php on line 45

Este mensaje te está diciendo que en el archivo functions.php del tema, en la línea 45, hay una variable que no tiene un valor definido.

¿Cómo interpretar los errores de WordPress?

Los errores que verás pueden ser de varios tipos:

Warning: Avisos de problemas menores que no detienen la ejecución del sitio.
Notice: Avisos informativos sobre posibles problemas.
Fatal error: Errores graves que detienen la ejecución del sitio.
Deprecated: Funciones obsoletas que deberían actualizarse.

Cada error te indica el archivo y la línea exacta. Con esta información, puedes buscar en Google el mensaje de error o revisar el archivo indicado para corregir el problema.

[TIP] Si el error viene de un plugin o tema, la solución más rápida suele ser actualizar ese plugin o tema a la última versión.

¿Cuándo desactivar el modo debug?

El modo debug wordpress no debería estar activo permanentemente en un sitio en producción. Mostrar errores en pantalla puede dar información sensible a los visitantes y no es profesional.

Una vez que hayas solucionado los errores, vuelve a poner:

define('WP_DEBUG', false);

O si quieres mantener el log sin mostrar errores, usa:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Así los errores se seguirán registrando en el archivo debug.log, pero no se mostrarán a los visitantes.

Errores comunes al activar el modo debug

Error: "Headers already sent"

Este error suele aparecer si hay espacios en blanco o caracteres extraños antes de la etiqueta <?php en el wp-config.php o en otros archivos. Revisa que el archivo empiece exactamente con <?php sin ningún espacio antes.

Error: "Allowed memory size exhausted"

Este error indica que WordPress necesita más memoria de la que tiene asignada. Puedes aumentarla añadiendo esta línea al wp-config.php:

define('WP_MEMORY_LIMIT', '256M');

Error: "Fatal error: Call to undefined function"

Este error suele estar relacionado con un plugin o tema que llama a una función que no existe. Revisa si el plugin o tema está actualizado o si hay conflictos entre ellos.

[WARNING] No dejes el modo debug activo en un sitio en producción si no es necesario. Los errores en pantalla pueden ser visibles para los visitantes y dar una mala imagen de tu web.

¿Dónde encontrar el archivo debug.log?

Si has activado WP_DEBUG_LOG, los errores se guardan en un archivo llamado debug.log dentro de la carpeta wp-content. Puedes acceder a él mediante FTP o el administrador de archivos de tu hosting.

Este archivo puede crecer mucho si hay muchos errores, así que es recomendable borrarlo de vez en cuando.

¿Qué hacer si no ves ningún error?

Si has activado el modo debug y no aparece ningún error, pero tu web sigue dando problemas, puede ser que el error esté relacionado con la configuración del servidor o con el navegador.

Algunas cosas que puedes probar:

Desactiva todos los plugins y activa uno por uno para ver cuál causa el problema.
Cambia a un tema por defecto como Twenty Twenty-Four para descartar problemas del tema.
Revisa los logs del servidor en tu panel de control.

[INFO] Si tu hosting usa Syspanel, puedes acceder a los logs del servidor desde el panel, en la sección de "Registros" o "Logs". Recuerda que el acceso a Syspanel es a través del puerto 2106.

Consejos finales para ver errores wordpress como un profesional

Haz siempre una copia de seguridad del wp-config.php antes de modificarlo.
Usa un tema hijo si vas a modificar el tema, así no perderás los cambios al actualizar.
Activa el modo debug solo cuando lo necesites y desactívalo después de solucionar el problema.
Consulta el debug.log regularmente para detectar errores de forma proactiva.
No temas a los errores, son la mejor herramienta para diagnosticar problemas.

Preguntas frecuentes sobre el modo debug de WordPress

¿Es seguro activar el modo debug en mi sitio?

Sí, es seguro, pero debes desactivarlo cuando hayas terminado de diagnosticar el problema. No es recomendable tenerlo activo en un sitio en producción.

¿Puedo activar el modo debug sin acceso al archivo wp-config.php?

No, necesitas acceso al archivo para modificar las constantes. Si no tienes acceso por FTP, usa el administrador de archivos de tu hosting.

¿El modo debug afecta al rendimiento de mi web?

Sí, ligeramente. Mostrar errores en pantalla y guardar logs consume recursos, pero el impacto es mínimo y solo notarás diferencia en sitios muy grandes.

¿Qué hago si no puedo editar el wp-config.php?

Si no puedes editar el archivo, contacta con tu proveedor de hosting. Ellos pueden ayudarte a activar el modo debug o a revisar los logs del servidor.

¿Cómo sé si mi web tiene errores sin activar el modo debug?

Puedes consultar el archivo debug.log si ya estaba activado, o revisar los logs del servidor en tu panel de control.

Conclusión

Activar el modo debug wordpress es una de las habilidades más útiles que puedes aprender como propietario de una web. Te permite diagnosticar problemas de forma rápida y eficiente, sin necesidad de adivinar o probar a ciegas.

Recuerda siempre trabajar con una copia de seguridad, hacer cambios pequeños y comprobar los resultados. Con la configuración que te he mostrado, podrás ver errores wordpress de forma clara y entender exactamente qué está pasando en tu sitio.

Ahora que ya sabes cómo hacerlo, te animo a que lo pruebes. Activa el modo debug, visita tu web y mira qué errores aparecen. Te sorprenderá lo mucho que puedes aprender sobre tu instalación de WordPress simplemente leyendo los mensajes de error.