Errores Comunes de WordPress (cPanel/Plesk) y Cómo Solucionarlos

¿Tu WordPress ha dejado de funcionar de repente y te aparece una pantalla en blanco, un error 500 o un mensaje críptico en el panel de control? Respira hondo. No eres el primero al que le pasa, y lo más importante: casi todos estos errores tienen solución y no requieren que seas un experto en programación.

En esta guía extensa y práctica, vamos a desglosar los errores WordPress más comunes que aparecen en el panel de control (cPanel, Syspanel, Plesk, etc.) y te voy a explicar paso a paso cómo solucionar errores WordPress sin perder los nervios.

Vamos a empezar por el principio: entender qué está pasando.

¿Por qué aparecen errores en WordPress?

WordPress es un software que depende de tres pilares: el servidor (donde se aloja tu web), la base de datos (donde se guarda tu contenido) y los archivos (los temas y plugins). Si uno de estos tres falla, el panel de control o tu web te mostrará un error.

La mayoría de las veces, estos fallos ocurren por:

Un plugin o tema incompatible o mal actualizado.
Falta de memoria PHP en el servidor.
Archivos corruptos o permisos incorrectos.
Problemas con la base de datos.
Configuración incorrecta del servidor web (Apache, Nginx, LiteSpeed).

No te preocupes, vamos a ver cómo atacar cada uno de ellos.

Error 500 WordPress: El más temido y el más común

El error 500 wordpress es un cajón de sastre. Significa que algo falla en el servidor, pero no te dice exactamente qué. Es como cuando tu coche no arranca: puede ser la batería, el motor o que no tiene gasolina.

### Paso 1: Activa el modo de depuración (WP_DEBUG)

Este es el primer paso para solucionar errores WordPress de forma lógica. Necesitas ver el error real detrás de la pantalla blanca o el 500.

Accede a tu panel de control de hosting (ej. Syspanel en el puerto 2106, o cPanel).
Busca el Administrador de Archivos (File Manager).
Navega a la carpeta public_html o htdocs (donde está tu WordPress).
Busca el archivo llamado wp-config.php.
Ábrelo con el editor de texto y busca la línea que dice define('WP_DEBUG', false);.
Cámbiala por esto:

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

Guarda el archivo e intenta cargar tu web de nuevo.

Si el error persiste, ahora habrá un archivo llamado debug.log en tu carpeta wp-content. Ábrelo desde el Administrador de Archivos y busca la línea que dice "Fatal error". Ahí te dirá exactamente qué archivo está causando el problema (normalmente un plugin).

[INFO] Si no ves el archivo debug.log, créalo tú mismo con un bloc de notas vacío y súbelo a la carpeta wp-content con permisos 644.

### Paso 2: Aumenta la memoria PHP

Uno de los culpables más frecuentes del error 500 wordpress es la falta de memoria. WordPress necesita un mínimo de 64MB, pero te recomiendo 128MB o 256MB.

Ve al Administrador de Archivos de nuevo.
Busca el archivo .htaccess (en la raíz).
Añade estas líneas al final:

php_value memory_limit 256M
php_value max_execution_time 300

Guarda y recarga.

Si no funciona, crea un archivo llamado php.ini en la raíz y añade:

memory_limit = 256M
max_execution_time = 300

### Paso 3: Revisa los permisos de archivos

A veces, tras una restauración o una copia de seguridad, los permisos se rompen. Esto causa el error 500.

Las carpetas deben tener permisos 755.
Los archivos deben tener permisos 644.

En tu panel de control, selecciona todos los archivos y carpetas de public_html y cámbialos. Si usas Syspanel, busca la opción "Permisos" en el menú superior.

Error 502 Bad Gateway: El problema está en el servidor

El error 502 wordpress (Bad Gateway) es diferente. Significa que el servidor web (Apache/Nginx) no puede comunicarse con el proceso de PHP. Es un problema de infraestructura, no de tu código.

### Causa 1: PHP-FPM caído o saturado

Esto es lo más común. El servicio PHP se ha bloqueado.

Solución:

Entra en tu panel de control (ej. Syspanel).
Busca la sección "Servicios" o "Procesos".
Localiza el servicio llamado PHP-FPM o LiteSpeed.
Haz clic en "Reiniciar" o "Restart".

[WARNING] No reinicies Apache o Nginx si no sabes lo que haces. Con reiniciar PHP-FPM suele ser suficiente.

### Causa 2: Tiempo de espera agotado

Si tu script tarda demasiado en ejecutarse, el servidor intermedio corta la conexión y devuelve el 502.

Solución:
Añade esto a tu wp-config.php justo antes de la línea que dice /* That's all, stop editing! */:

set_time_limit(300);

Error "Error al conectar con la base de datos"

Este es uno de los errores wordpress más fáciles de identificar. Verás una pantalla amarilla o roja que dice exactamente eso.

### Paso 1: Verifica las credenciales en wp-config.php

Abre el wp-config.php.
Busca estas líneas:

define('DB_NAME', 'tu_basededatos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_password');
define('DB_HOST', 'localhost');

Asegúrate de que coinciden con los datos que te dio tu proveedor de hosting.
Presta atención a DB_HOST. No siempre es localhost. A veces es algo como mysql.servidor.com o localhost:3306.

### Paso 2: Repara la base de datos

WordPress tiene una herramienta oculta para reparar la base de datos.

Añade esta línea a tu wp-config.php:

define('WP_ALLOW_REPAIR', true);

Ve a tu navegador y escribe: tudominio.com/wp-admin/maint/repair.php
Haz clic en "Reparar base de datos".
Cuando termine, borra esa línea del wp-config.php.

Pantalla Blanca de la Muerte (WSOD)

No hay error, solo una página en blanco. Es frustrante, pero tiene fácil arreglo.

### Solución: Desactiva todos los plugins manualmente

Si no puedes acceder al panel de administración, tendrás que hacerlo por FTP o por el Administrador de Archivos.

Entra en tu panel de control.
Ve a la carpeta wp-content.
Renombra la carpeta plugins a plugins_desactivados.
Recarga tu web.

Si la web vuelve a funcionar, el problema es un plugin. Ahora, renombra la carpeta de nuevo a plugins y ve activando uno a uno desde el panel de administración (si ya puedes entrar) hasta encontrar el culpable.

Error "El enlace que has seguido ha caducado"

Este error suele aparecer al subir un tema o plugin grande.

### Solución: Aumenta el límite de subida

Necesitas aumentar el tamaño máximo de archivo que permite PHP.

Crea un archivo llamado php.ini en la raíz de tu WordPress.
Añade:

upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300

Guarda y sube el archivo.

[TIP] Si usas Syspanel, puedes cambiar estos valores gráficamente en la sección "Configuración PHP" sin crear archivos.

Error 403 Forbidden: Problemas de permisos

Este error indica que no tienes permiso para acceder a un archivo o carpeta.

### Solución: Restablece los permisos base

Ve al Administrador de Archivos.
Selecciona la carpeta wp-content.
Cambia los permisos a 755 de forma recursiva (incluyendo subcarpetas).
Selecciona los archivos dentro de wp-content y cámbialos a 644.

Mantenimiento inesperado

A veces WordPress se queda atascado en "Modo mantenimiento" porque una actualización falló.

### Solución: Borra el archivo .maintenance

En el Administrador de Archivos, ve a la raíz.
Activa la opción de "Mostrar archivos ocultos" (suele estar en la esquina superior derecha).
Busca un archivo llamado .maintenance.
Bórralo.

Eso es todo, tu web volverá a la normalidad al instante.

FAQ: Preguntas rápidas para solucionar errores WordPress

¿Qué hago si no tengo acceso al panel de control?
Si no tienes acceso al panel de control, contacta con tu proveedor de hosting. Ellos pueden reiniciar los servicios o darte acceso temporal por FTP.

¿Puedo evitar estos errores en el futuro?
Sí. Mantén WordPress, tus temas y plugins siempre actualizados. Haz copias de seguridad semanales (la mayoría de los paneles como Syspanel tienen esta opción gratuita) y evita instalar plugins de fuentes desconocidas.

¿El error 500 y el 502 son lo mismo?
No. El 500 es un error interno del servidor (tu código o configuración). El 502 es un error de comunicación entre el servidor web y el PHP. El 502 suele solucionarse reiniciando el servicio PHP, mientras que el 500 requiere que revises tu wp-config.php y tus plugins.

¿Puedo usar el plugin "Health Check" para diagnosticar?
Sí, pero si tu web está caída, no podrás instalarlo. Úsalo como prevención cuando tu web funcione. Te avisará de problemas de configuración antes de que se conviertan en un error grave.

Resumen final: No entres en pánico

Los errores wordpress son parte del día a día de cualquier administrador web. La clave está en la metodología:

Diagnostica: Activa WP_DEBUG para ver el error real.
Aísla: Desactiva plugins y cambia a un tema por defecto (Twenty Twenty-Four).
Ajusta recursos: Aumenta la memoria PHP y el tiempo de ejecución.
Revisa permisos: Asegúrate de que las carpetas sean 755 y los archivos 644.

Con estos pasos, resolverás el 90% de los problemas. Y recuerda, si usas Syspanel, tienes acceso a herramientas gráficas que te facilitan mucho la vida, como el reinicio de servicios y la gestión de PHP, todo desde el puerto 2106.

[WARNING] Si después de seguir todos estos pasos el error persiste, no intentes "parchear" a lo loco. Contacta con el soporte de tu hosting. A veces el problema está en el servidor y no en tu WordPress.

Ahora que ya sabes cómo solucionar los errores más comunes, te invito a guardar esta guía. La próxima vez que veas un error 500, ya sabrás exactamente por dónde empezar. ¡Mucha suerte!