Activar WP_DEBUG en WordPress: Depuración fácil

¿Qué es el modo de depuración (WP_DEBUG) y para qué sirve?

Cuando tu sitio web de WordPress falla, muestra una pantalla blanca o errores extraños, la causa suele ser un conflicto entre plugins, temas o un error de código PHP. Para encontrar la raíz del problema, necesitas activar el modo debug WordPress. Este modo es una herramienta de diagnóstico integrada que le dice a WordPress que muestre los errores PHP directamente en la pantalla o que los registre en un archivo de log.

Piénsalo como una luz de check-engine en tu coche. Sin ella, solo sabes que algo va mal, pero no qué es. Al activar wp_debug wordpress, obtienes el informe detallado del mecánico: el código exacto del error, el archivo y la línea donde ocurre. Esto te permite solucionar el problema de forma precisa, en lugar de ir probando a ciegas.

Para usuarios sin experiencia técnica, puede sonar intimidante, pero es un proceso muy sencillo. Solo necesitas editar un archivo de configuración. A continuación, te explicamos paso a paso cómo hacerlo de forma segura, incluso si nunca has tocado código.

Antes de empezar: prepara tu sitio

Activar el modo debug WordPress mostrará errores que normalmente están ocultos. Esto puede ser abrumador, pero es la información que necesitas. Sigue estas recomendaciones antes de comenzar:

[WARNING] Haz una copia de seguridad completa de tu sitio (archivos y base de datos) antes de hacer cualquier cambio. Si algo sale mal, podrás restaurar todo a su estado original.

[INFO] Te recomendamos hacer estos cambios en un entorno de pruebas o en un subdominio si es posible. Si no es posible, no te preocupes, el proceso es reversible y lo explicaremos al final.

Método 1: Editar el archivo wp-config.php (el más común)

Este es el método estándar y el que funciona en el 99% de los casos. El archivo wp-config.php es el corazón de la configuración de WordPress.

Paso 1: Accede a tu hosting o panel de control

Necesitas acceder a los archivos de tu sitio. Tienes dos opciones principales:

Usar un cliente FTP como FileZilla.
Usar el administrador de archivos de tu panel de hosting.

Si usas Syspanel (el panel de control de HestiaCP), el acceso es muy sencillo. Recuerda que la URL de acceso es https://tu-dominio.com:2106. Una vez dentro, busca la sección "Administrador de archivos" o "File Manager".

Paso 2: Localiza el archivo wp-config.php

Dentro del administrador de archivos, navega hasta la carpeta raíz de tu instalación de WordPress. Normalmente se llama public_html, htdocs o el nombre de tu dominio. Dentro de esa carpeta, busca el archivo llamado wp-config.php.

Paso 3: Edita el archivo

Haz clic derecho sobre el archivo y selecciona "Editar" o "Edit". Se abrirá un editor de texto. Busca la línea que dice:

define( 'WP_DEBUG', false );

Si no la encuentras, busca la línea que dice:

/* ¡Eso es todo! Deja de editar. ¡Feliz blogging! */

Justo antes de esa línea, añade el siguiente bloque de código:

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

Paso 4: Guarda los cambios

Guarda el archivo y súbelo de vuelta al servidor si usas FTP. Si usas el administrador de archivos, simplemente guarda.

[TIP] Al poner WP_DEBUG_DISPLAY en false y WP_DEBUG_LOG en true, los errores no se mostrarán en tu sitio web (evitando que los visitantes vean mensajes feos), pero se guardarán en un archivo de registro llamado debug.log. Este archivo se creará automáticamente en la carpeta wp-content. Es la forma más segura y limpia de diagnosticar problemas.

Método 2: Usar un plugin (más fácil para principiantes)

Si editar archivos te da miedo, existe una alternativa mucho más visual y amigable: usar un plugin. Uno de los más populares y fáciles de usar es WP Debugging.

Paso 1: Instala el plugin

Ve a tu escritorio de WordPress > Plugins > Añadir nuevo. Busca "WP Debugging" e instálalo y actívalo.

Paso 2: Activa el modo debug

Una vez activado, ve a Ajustes > WP Debugging. Verás una interfaz simple con opciones. Simplemente activa la casilla que dice "Enable WP_DEBUG" (Activar WP_DEBUG). El plugin se encargará de hacer los cambios en el archivo wp-config.php por ti.

Paso 3: Comprueba el log

El plugin también te mostrará la ruta al archivo de log y te permitirá descargarlo directamente desde el panel de administración. Es la opción más cómoda si no quieres lidiar con código.

¿Cómo leer el archivo de errores (debug.log)?

Una vez que hayas activado wp_debug wordpress y hayas navegado por tu sitio para reproducir el error, se habrá creado un archivo llamado debug.log en la carpeta wp-content.

Para leerlo, ve a wp-content/debug.log a través de tu administrador de archivos. Ábrelo y verás líneas de texto similares a esta:

[12-Mar-2025 10:15:32 UTC] PHP Warning:  Undefined array key "my_option" in /home/user/public_html/wp-content/plugins/mi-plugin/funciones.php on line 45

Vamos a desglosarlo:

Fecha y hora: Cuándo ocurrió el error.
Tipo de error: Puede ser "Warning" (Aviso), "Notice" (Notificación) o "Fatal error" (Error fatal). Los errores fatales son los que causan la pantalla blanca.
Mensaje: La descripción del problema. En este caso, "Undefined array key" significa que el código intenta usar una variable que no existe.
Ruta del archivo: El archivo exacto donde ocurre el error. Esto es oro puro para encontrar al culpable.
Número de línea: La línea específica en ese archivo.

Con esta información, puedes identificar qué plugin o tema está causando el problema. Por ejemplo, si la ruta dice wp-content/plugins/mi-plugin, sabrás que el plugin "mi-plugin" es el responsable.

¿Qué hago con esta información? (Casos prácticos)

Ahora que tienes el error, ¿cómo lo solucionas? Aquí tienes los escenarios más comunes:

El error viene de un plugin específico: Ve a Plugins > Plugins instalados. Desactiva ese plugin. Si el error desaparece, el problema es de ese plugin. Busca una actualización, contacta al desarrollador o busca una alternativa.
El error viene de tu tema: Ve a Apariencia > Temas. Cambia temporalmente a un tema por defecto de WordPress (como Twenty Twenty-Four). Si el error desaparece, el problema es de tu tema. Contacta a su desarrollador.
El error es de un fragmento de código en functions.php: Si añadiste código personalizado al archivo functions.php de tu tema, es muy probable que el error venga de ahí. Revisa la línea indicada en el log y corrige la sintaxis.
El error es de memoria: Si ves un error como "Allowed memory size of X bytes exhausted", significa que tu sitio necesita más memoria PHP. Puedes aumentarla añadiendo esta línea a tu wp-config.php:

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

Cómo desactivar el modo debug WordPress (Vuelve a la normalidad)

Una vez que hayas solucionado el problema, es muy importante desactivar el modo debug. Dejarlo activo en un sitio de producción es un riesgo de seguridad, ya que expone rutas internas de tu servidor y puede ralentizar tu sitio.

Si usaste el método manual:

Vuelve a editar el archivo wp-config.php y cambia las líneas que añadiste. Puedes poner WP_DEBUG en false o, mejor aún, eliminar las líneas que añadiste para dejar el archivo como estaba originalmente.

Si usaste el plugin:

Ve a Ajustes > WP Debugging y desactiva la casilla "Enable WP_DEBUG". El plugin revertirá los cambios.

[WARNING] No olvides eliminar el archivo debug.log de la carpeta wp-content después de desactivar el modo debug. Este archivo puede contener información sensible de tu servidor.

Preguntas frecuentes (FAQ) sobre el modo debug

¿Es seguro activar el modo debug WordPress?

Sí, es seguro si sigues las recomendaciones. La clave es poner WP_DEBUG_DISPLAY en false para que los errores no se muestren a los visitantes. El riesgo principal es olvidar desactivarlo después de solucionar el problema.

¿Por qué no veo errores en mi sitio aunque active WP_DEBUG?

Es probable que tengas WP_DEBUG_DISPLAY en false (como recomendamos). Los errores se están guardando en el archivo debug.log. Revisa la carpeta wp-content para encontrarlo. Si no existe, intenta navegar por las páginas que causan el problema para generar nuevos errores.

¿Puedo activar el modo debug desde el panel de administración de WordPress?

No directamente, a menos que uses un plugin como "WP Debugging" que lo hace por ti. El método manual requiere editar el archivo wp-config.php.

¿Qué significa "errores php wordpress"?

Son cualquier error que ocurre en el código PHP que ejecuta WordPress. Estos errores pueden ser desde avisos menores (warnings) hasta errores fatales que detienen la ejecución del sitio. El modo debug es la herramienta para verlos.

¿El modo debug afecta el rendimiento de mi sitio?

Sí, ligeramente. Al registrar todos los errores, el servidor tiene que hacer trabajo extra. Por eso es importante activarlo solo durante el diagnóstico y desactivarlo después.

¿Puedo usar el modo debug para mejorar el SEO de mi sitio?

Indirectamente, sí. Al encontrar y corregir errores de PHP que causan páginas en blanco o tiempos de carga lentos, mejoras la experiencia del usuario y, por lo tanto, el SEO. Un sitio con errores es penalizado por Google.

Conclusión y mejores prácticas

Activar el modo debug WordPress es una habilidad esencial para cualquier persona que gestione un sitio con WordPress. No es un proceso complicado y te ahorrará horas de frustración cuando algo falle.

Para resumir, sigue estas mejores prácticas:

Activa el modo debug solo cuando lo necesites.
Usa siempre WP_DEBUG_LOG en true y WP_DEBUG_DISPLAY en false para no afectar a tus visitantes.
Revisa el archivo debug.log para encontrar la causa raíz.
Desactiva el modo debug y elimina el archivo de log cuando termines.
Si usas Syspanel, recuerda que el acceso es por el puerto 2106 para gestionar tus archivos.

Con esta guía, ya tienes las herramientas para diagnosticar y solucionar los errores de tu sitio por ti mismo. ¡No le temas a los errores de PHP! Son solo mensajes que te dicen exactamente qué tienes que arreglar.