Activar y ver los logs de error de WordPress en Plesk (debug.log)

¿Por qué WordPress se queda en blanco y qué tienen que ver los logs?

Seguro que te ha pasado: un día entras a tu web y... pantalla en blanco. O peor, aparece el temido "Error estableciendo conexión con la base de datos". Cuando esto ocurre, WordPress no te dice nada más. Es como un coche que no arranca y no hace ni ruido. Pues bien, los logs de error son la "caja negra" de tu WordPress. Ahí se registra exactamente qué ha fallado y en qué archivo.

En este artículo te voy a enseñar, paso a paso y sin tecnicismos raros, cómo ver los logs error wordpress plesk, cómo activar el debug wordpress plesk y, lo más importante, cómo interpretar lo que ves para poder arreglarlo. No necesitas ser un programador, solo seguir las instrucciones al pie de la letra.

¿Qué es el archivo debug.log y para qué sirve?

WordPress tiene un sistema de depuración (debugging) que está desactivado por defecto. Cuando lo activas, el sistema empieza a escribir un archivo llamado debug.log dentro de la carpeta wp-content. Este archivo registra:

Errores de PHP (avisos, warnings, errores fatales).
Conflictos entre plugins o temas.
Llamadas a funciones que ya no existen.
Problemas de memoria.
Errores de sintaxis en archivos modificados.

En resumen: es el primer lugar donde debes mirar cuando algo falla. Sin él, estás a ciegas.

Activar el debug de WordPress en Plesk (método manual)

Plesk es un panel de control muy común en el hosting. No tiene un botón mágico para activar el debug de WordPress, pero podemos hacerlo editando el archivo wp-config.php. No te asustes, es más fácil de lo que parece.

Paso 1: Accede al administrador de archivos de Plesk

Entra a tu panel de Plesk.
Busca la sección "Archivos" o "File Manager" en el menú lateral.
Navega hasta la carpeta raíz de tu WordPress (normalmente httpdocs o public_html).
Busca el archivo llamado wp-config.php. Si no lo ves, activa la opción de "mostrar archivos ocultos".

Paso 2: Edita el archivo wp-config.php

Haz clic derecho sobre wp-config.php y selecciona "Editar".
Busca la línea que dice /* ¡Eso es todo, deja de editar! Happy publishing. */.
Justo antes de esa línea, pega el siguiente código:

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

¿Qué significa cada línea?

WP_DEBUG: activa el modo depuración.
WP_DEBUG_LOG: guarda los errores en el archivo debug.log.
WP_DEBUG_DISPLAY: evita que los errores se muestren en pantalla (recomendado para sitios en producción, para que los visitantes no vean mensajes raros).

Paso 3: Guarda y verifica

Guarda los cambios y cierra el editor. Ahora, cada vez que ocurra un error, se escribirá en un archivo nuevo llamado debug.log dentro de la carpeta wp-content.

¿Cómo ver los logs de error de WordPress en Plesk?

Una vez activado el debug, ya puedes ver errores wordpress plesk. Tienes dos formas de hacerlo: desde el administrador de archivos o por FTP.

Opción A: Desde el administrador de archivos de Plesk

Ve a "Archivos" en Plesk.
Entra a la carpeta wp-content.
Busca el archivo debug.log. Si no existe, significa que aún no ha habido errores o que el debug no está activo.
Haz clic derecho sobre el archivo y selecciona "Ver" o "Descargar".

Opción B: Por FTP (FileZilla o similar)

Conecta con tu servidor usando las credenciales FTP (las encuentras en Plesk, sección "FTP Access").
Navega hasta wp-content/debug.log.
Descarga el archivo y ábrelo con cualquier editor de texto (Bloc de notas, Sublime, VS Code).

[INFO] El archivo debug.log puede crecer mucho con el tiempo. Te recomiendo vaciarlo de vez en cuando: simplemente borra su contenido y guárdalo vacío, o elimina el archivo. WordPress lo volverá a crear cuando haya un nuevo error.

Interpretando los errores más comunes

Ver el log es solo la mitad del trabajo. La otra mitad es entender qué dice. No te preocupes, los errores más comunes son fáciles de identificar:

1. Errores fatales (Fatal error)

Ejemplo:

PHP Fatal error: Uncaught Error: Call to undefined function wp_foo() in /var/www/html/wp-content/themes/mi-tema/functions.php:45

Qué significa: Estás llamando a una función que no existe. Suele pasar al activar un plugin o tema mal codificado.

Solución: Revisa el archivo y la línea indicada. Si es un plugin, desactívalo desde la base de datos o por FTP renombrando la carpeta del plugin.

2. Warnings y Notices

Ejemplo:

PHP Warning: file_get_contents(...): failed to open stream: No such file or directory in ...

Qué significa: Son avisos, no errores fatales. Tu web seguirá funcionando, pero algo no está bien (generalmente una ruta incorrecta o un recurso que no se encuentra).

Solución: Normalmente se arreglan actualizando el plugin o tema que lo genera.

3. Errores de memoria

Ejemplo:

PHP Fatal error: Allowed memory size of 67108864 bytes exhausted

Qué significa: Tu WordPress necesita más memoria de la que tiene asignada.

Solución: Aumenta el límite de memoria en wp-config.php añadiendo:

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

Alternativa rápida: activar el debug desde el hosting

Si no te sientes cómodo editando archivos, algunos paneles de control ofrecen herramientas. En Syspanel (recuerda, es el antiguo HestiaCP, se accede por el puerto 2106), tienes una opción interesante:

Entra a tu Syspanel usando http://tu-dominio.com:2106.
Ve a la sección de "WordPress" o "Herramientas".
Busca la opción de "Depuración" o "Debug".
Activa el modo debug y guarda.

[TIP] Si usas Syspanel, no necesitas tocar código. Es la opción más cómoda para principiantes.

Desactivar el debug cuando termines

Esto es muy importante. Dejar el debug activado en un sitio en producción es mala práctica porque:

Ralentiza ligeramente la web.
Crea archivos de log que consumen espacio.
Si WP_DEBUG_DISPLAY está en true, podrías mostrar errores a los visitantes.

Cuando hayas resuelto el problema, vuelve a wp-config.php y cambia las líneas a:

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

O simplemente elimina las líneas que añadiste.

[WARNING] Nunca dejes WP_DEBUG_DISPLAY en true en un sitio en producción. Es un riesgo de seguridad y una mala imagen para tus visitantes.

¿Y si el debug.log no aparece?

Puede pasar. Si activaste el debug y no ves el archivo, revisa:

Permisos de carpeta: La carpeta wp-content debe tener permisos de escritura (755 o 775).
Espacio en disco: Si el servidor está lleno, no puede crear el archivo.
PHP configurado para ocultar errores: Algunos hosts tienen display_errors desactivado a nivel de servidor. En ese caso, el log se escribe igualmente, pero no verás nada en pantalla.
Caché: Si usas un plugin de caché, puede estar interfiriendo. Desactívalo temporalmente.

Caso práctico: mi web da error 500

Te voy a contar un caso típico. Un cliente me escribió diciendo que su web daba error 500 en todas las páginas. Lo primero que hice fue activar el debug como te he explicado. En el debug.log apareció:

PHP Parse error: syntax error, unexpected '}' in /wp-content/themes/mi-tema/functions.php on line 120

Era un error de sintaxis. Había editado functions.php y le sobraba una llave }. Lo corregí, guardé y la web volvió a funcionar. Sin el log, habría estado horas mirando el código a ciegas.

Preguntas frecuentes (FAQ)

¿Puedo ver los logs de error de WordPress sin tocar código?

Sí. Algunos plugins como "WP Debugging" o "Query Monitor" te permiten activar el debug desde el panel de administración. Eso sí, necesitas acceso al admin de WordPress, algo que no siempre tienes si la web está caída.

¿Cuánto tarda en aparecer un error en el debug.log?

Es inmediato. En cuanto ocurre un error, se escribe en el archivo. Si no ves nada, es que no ha habido errores o que el archivo no tiene permisos de escritura.

¿Puedo usar estos logs para mejorar el SEO?

Indirectamente, sí. Si tu web tiene errores de PHP, Google puede penalizarte porque la experiencia de usuario es mala. Corregir errores mejora la velocidad y la estabilidad, lo que siempre es positivo para el posicionamiento.

¿Qué hago si el log es enorme?

Bórralo. WordPress lo volverá a crear desde cero. Es un archivo de texto, no pasa nada por eliminarlo.

¿Necesito conocimientos de programación?

No. Con saber copiar y pegar el código que te he dado, y con leer el archivo de log, es suficiente. Si el error es complejo, siempre puedes copiar la línea del error y buscarla en Google o preguntar en foros de WordPress.

Resumen: los logs son tu mejor amigo

Ya lo ves, ver errores wordpress plesk no es complicado. Solo necesitas:

Activar el debug en wp-config.php.
Esperar a que ocurra el error.
Leer el archivo debug.log desde Plesk o FTP.
Interpretar el mensaje y buscar la solución.

Con esto podrás resolver el 90% de los problemas de tu WordPress sin llamar al soporte técnico. Y recuerda: cuando termines, desactiva el debug para mantener tu web rápida y segura.

Si te ha quedado alguna duda, déjala en los comentarios. Estaré encantado de ayudarte.