Errores comunes en WordPress: Soluciones desde el panel

¿Te ha pasado que intentas acceder al panel de control de tu WordPress y te encuentras con una pantalla en blanco, un mensaje de error crítico o, peor aún, un mensaje que te pide tus credenciales de acceso a la base de datos? Tranquilo, no eres el único. Estos errores WordPress son más comunes de lo que parecen y, en la mayoría de los casos, tienen una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

En esta guía extensa y paso a paso, vamos a solucionar problemas WordPress directamente desde tu panel de control de hosting. Te explicaré cada error como si estuviera sentado a tu lado, con un lenguaje claro y ejemplos prácticos. Recuerda que, para acceder a todas las herramientas que mencionaremos, normalmente entrarás a tu panel de control (como cPanel, Plesk o Syspanel, cuyo puerto de acceso es el 2106) para gestionar archivos y bases de datos.

Vamos a desglosar los fallos más frecuentes, desde el temido "Error de conexión a la base de datos" hasta el molesto "El enlace que has seguido ha caducado". Prepárate para convertirte en el héroe de tu propio sitio web.

Error de conexión a la base de datos

Este es, sin duda, uno de los errores WordPress más alarmantes. De repente, tu web se vuelve inaccesible y solo ves un mensaje que dice: "Error al establecer una conexión a la base de datos". No entres en pánico. Generalmente, esto significa que WordPress no puede comunicarse con la base de datos donde se almacena todo tu contenido.

¿Por qué ocurre?

Las causas más comunes son:

Credenciales incorrectas: El archivo wp-config.php tiene datos de acceso (usuario, contraseña, nombre de la base de datos) que ya no son válidos.
Base de datos dañada: A veces, tras una actualización fallida o un corte de energía, la base de datos se corrompe.
Servidor de base de datos caído: El problema no está en tu web, sino en el servidor de hosting. En este caso, solo debes esperar.

Cómo solucionarlo paso a paso

Accede a tu panel de control de hosting. Si usas Syspanel, recuerda que el puerto de acceso es el 2106 (ejemplo: tudominio.com:2106). Busca la sección de "Bases de datos" o "phpMyAdmin".
Verifica las credenciales en wp-config.php. Dentro del panel, usa el "Administrador de archivos" para navegar hasta la carpeta raíz de tu WordPress (normalmente public_html). Busca el archivo wp-config.php y ábrelo con un editor de texto.
Revisa estas líneas:
```
define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'usuario_de_la_bd');
define('DB_PASSWORD', 'contraseña_de_la_bd');
define('DB_HOST', 'localhost');
```
Asegúrate de que coincidan exactamente con los datos que tienes en tu panel de bases de datos. Si cambiaste la contraseña de la base de datos desde el panel, debes actualizarla aquí también.
Repara la base de datos. Si las credenciales son correctas, añade esta línea justo antes de la línea que dice /* That's all, stop editing! */:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo y luego visita tudominio.com/wp-admin/maint/repair.php. Verás una opción para reparar la base de datos. Una vez hecho, borra esa línea del archivo, porque dejarla activa es un riesgo de seguridad.

[TIP] Si después de reparar sigue sin funcionar, contacta a tu soporte de hosting. A veces el problema es que el servicio MySQL está detenido.

Pantalla blanca de la muerte (WSOD)

La temida "White Screen of Death" es otro clásico de los errores WordPress. Cuando intentas acceder a tu panel de control o a tu web, solo ves una página en blanco, sin ningún mensaje de error. Esto suele deberse a un conflicto entre plugins, temas o un límite de memoria excedido.

Causas principales

Plugin o tema incompatible: Instalaste algo nuevo y rompió todo.
Límite de memoria PHP insuficiente: WordPress necesita más memoria de la que tiene asignada.
Error de sintaxis en un archivo: Si editaste código (functions.php, por ejemplo) y cometiste un error, el sitio colapsa.

Soluciones prácticas desde el panel de control

Desactiva todos los plugins. Accede al "Administrador de archivos" de tu panel de control (o usa FTP). Ve a la carpeta wp-content y cambia el nombre de la carpeta plugins a plugins_desactivados. Esto fuerza a WordPress a no cargar ningún plugin. Si el sitio se recupera, el problema es uno de ellos. Luego, renómbrala de nuevo a plugins y ve activándolos uno por uno desde el escritorio de WordPress (si ya puedes acceder).
Cambia temporalmente al tema por defecto. En la misma carpeta wp-content, busca la carpeta themes. Dentro de ella, localiza la carpeta de tu tema activo y renómbrala (por ejemplo, mitema a mitema_old). WordPress automáticamente intentará cargar un tema por defecto como Twenty Twenty-Four.
Aumenta el límite de memoria PHP. Edita el archivo wp-config.php y añade esta línea antes de la línea final:
```
define('WP_MEMORY_LIMIT', '256M');
```
Si no funciona, pide a tu hosting que aumente el límite desde el panel de control (a veces está en "PHP Settings" o "Select PHP Version").

[WARNING] Si después de estos pasos sigues viendo la pantalla blanca, revisa los logs de error de tu servidor. En cPanel o Syspanel (puerto 2106) suele haber una sección llamada "Error Log" o "Registro de errores". Allí verás la línea exacta del archivo que falla.

Error "El enlace que has seguido ha caducado"

Este mensaje aparece a menudo cuando intentas subir un archivo grande (como una imagen, un plugin o un tema) desde el panel de administración de WordPress. Es frustrante porque parece que todo está bien, pero al hacer clic en "Instalar" o "Subir", te salta el error.

¿Qué lo causa?

WordPress tiene límites de tamaño para las subidas, establecidos por la configuración de PHP de tu servidor. Si tu archivo supera ese límite, el sistema lo rechaza.

Cómo solucionarlo

Aumenta el límite de subida de archivos. La forma más directa es modificar el archivo .htaccess (que está en la raíz de tu instalación de WordPress). Añade estas líneas al final:
```
php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value max_execution_time 300
php_value max_input_time 300
```
Esto sube el límite a 64 MB. Si necesitas más, cambia el número.
Usa el panel de control de hosting. En Syspanel (puerto 2106), busca "PHP Settings" o "Select PHP Version". Allí podrás ajustar los valores de upload_max_filesize y post_max_size de forma gráfica.
Alternativa rápida: Si solo es para un archivo grande, súbelo por FTP a la carpeta wp-content/uploads (o a wp-content/plugins si es un plugin) y luego actívalo desde el escritorio de WordPress.

[INFO] Si después de cambiar estos valores el error persiste, es posible que tu hosting tenga restricciones de seguridad más estrictas. En ese caso, contacta con soporte y pídeles que aumenten los límites para tu dominio.

Error de actualización: "La descripción del paquete no se pudo instalar"

Este error es muy común cuando intentas actualizar WordPress, un plugin o un tema, y el proceso falla a mitad de camino. Puede deberse a permisos de archivos incorrectos o a una conexión FTP mal configurada.

Causas frecuentes

Permisos de archivos incorrectos: Las carpetas deben tener permisos 755 y los archivos 644.
Falta de espacio en disco: El servidor no tiene suficiente espacio para descargar e instalar la actualización.
Problemas de conexión FTP: Si WordPress intenta usar FTP para la actualización y las credenciales son erróneas, falla.

Soluciones paso a paso

Corrige los permisos de archivos. Desde el "Administrador de archivos" de tu panel, selecciona toda la carpeta de WordPress (normalmente public_html). Busca la opción "Permisos" o "Change Permissions". Establece 755 para las carpetas y 644 para los archivos. Si no sabes cómo hacerlo masivamente, puedes usar un plugin como "WP File Manager" (si tu sitio aún funciona) o pedir ayuda a tu hosting.
Libera espacio en el servidor. Revisa si tienes archivos temporales o copias de seguridad antiguas en tu panel de control. Bórralos para hacer espacio.
Desactiva la petición FTP. Edita wp-config.php y añade esta línea:
```
define('FS_METHOD', 'direct');
```
Esto obliga a WordPress a usar el sistema de archivos directo en lugar de FTP, lo que suele resolver el problema.

[TIP] Si el error persiste, descarga manualmente la última versión de WordPress desde wordpress.org, descomprímela y sube los archivos (excepto wp-content) por FTP, sobrescribiendo los existentes. Luego ejecuta la actualización de la base de datos desde tudominio.com/wp-admin/upgrade.php.

Error de sintaxis en el archivo functions.php

Este es un clásico cuando intentas personalizar tu tema añadiendo código al archivo functions.php. Un simple punto y coma olvidado o una llave mal cerrada puede dejar tu sitio inaccesible.

¿Cómo saber si es esto?

Si justo después de editar functions.php tu web deja de funcionar, el problema es casi seguro un error de sintaxis. No podrás acceder al panel de administración, pero sí al "Administrador de archivos" de tu panel de control.

Solución inmediata

Accede al "Administrador de archivos" de tu panel de control (cPanel, Plesk o Syspanel en el puerto 2106).
Navega a wp-content/themes/[nombre-de-tu-tema]/ y busca el archivo functions.php.
Descarga una copia de seguridad del archivo a tu ordenador (por si acaso).
Edita el archivo y revisa la última línea que añadiste. Busca errores comunes: falta de punto y coma al final de cada instrucción, llaves { } sin cerrar, o comillas sin terminar.
Si no estás seguro, borra el código que añadiste (o restaura la copia de seguridad) y guarda el archivo. El sitio debería volver a la vida.

[WARNING] Nunca edites functions.php directamente desde el editor de temas de WordPress si no tienes acceso de respaldo por FTP o panel de control. Si cometes un error, te quedarás sin acceso.

Error de memoria agotada (Allowed memory size exhausted)

Este error aparece como un texto en tu web o en el panel de administración, algo como: "Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes)". Significa que un script (plugin, tema o WordPress mismo) está pidiendo más memoria de la que tu servidor le permite usar.

Causas comunes

Un plugin mal optimizado que consume mucha memoria.
Una página con demasiados elementos (imágenes grandes, muchos posts en una sola página).
Un límite de memoria PHP muy bajo (por defecto suele ser 128 MB o menos).

Cómo solucionarlo

Aumenta el límite de memoria PHP temporalmente en wp-config.php:
```
define('WP_MEMORY_LIMIT', '256M');
```
Desactiva plugins uno por uno (como explicamos en la pantalla blanca) para encontrar al culpable. Usa el "Administrador de archivos" para renombrar la carpeta plugins si no puedes acceder al escritorio.
Optimiza tu sitio: Usa un plugin de caché, comprime imágenes y limita el número de revisiones de entradas. Puedes añadir esto a wp-config.php para limitar las revisiones:
```
define('WP_POST_REVISIONS', 5);
```

[INFO] Si el error persiste incluso con 256 MB, es probable que tu hosting tenga un límite duro. Pregunta a tu proveedor si pueden aumentarlo o considera cambiar a un plan superior.

Error 404 en páginas internas (enlaces rotos)

Este error es diferente al anterior. Tu web principal carga bien, pero cuando haces clic en una entrada o página, aparece un "404 Not Found". Esto suele pasar después de cambiar la estructura de enlaces permanentes (Permalinks) o migrar el sitio.

Solución rápida desde el panel de control

Accede al panel de administración de WordPress (si puedes) y ve a Ajustes > Enlaces permanentes.
Simplemente selecciona cualquier opción (por ejemplo, "Nombre de la entrada") y haz clic en "Guardar cambios". Esto regenera las reglas de reescritura de WordPress.
Si no puedes acceder al escritorio, edita el archivo .htaccess desde el "Administrador de archivos" de tu panel. Busca en la raíz de tu WordPress (si no existe, créalo). Pega este código:
```
# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress
```
Guarda y vuelve a intentar acceder a las páginas.

[TIP] Si después de esto sigues teniendo 404, es posible que tu servidor no tenga activado el módulo mod_rewrite de Apache. Contacta a tu hosting para que lo activen.

Error "No se pudo conectar con el servidor SMTP" (correo no funciona)

Este error no afecta a tu panel de control directamente, pero es muy común cuando intentas que WordPress envíe correos (como notificaciones de registro o recuperación de contraseñas). El mensaje suele aparecer en la configuración de algún plugin de correo.

Causas

El servidor SMTP no está configurado correctamente.
Tu hosting bloquea los envíos de correo por PHP (por seguridad).
Credenciales incorrectas del servicio de correo (Gmail, Outlook, etc.).

Solución

Usa un plugin SMTP como "WP Mail SMTP" o "Easy WP SMTP". Instálalo desde el repositorio de plugins de WordPress.
Configúralo con los datos de tu proveedor de correo. Por ejemplo, para Gmail:
- Servidor SMTP: smtp.gmail.com
- Puerto: 587 (TLS) o 465 (SSL)
- Autenticación: Sí
- Usuario: tu correo completo
- Contraseña: tu contraseña (o una contraseña de aplicación si tienes verificación en dos pasos).
Prueba el envío desde el plugin. Si no funciona, verifica que tu hosting no tenga bloqueado el puerto 587. En Syspanel (puerto 2106) puedes revisar la configuración de firewall o contactar a soporte.

Preguntas frecuentes (FAQ)

¿Qué hago si no puedo acceder ni al panel de control de hosting ni al de WordPress?

Si estás completamente bloqueado, contacta a tu proveedor de hosting por teléfono o ticket. Ellos tienen acceso de administrador al servidor y pueden desactivar plugins o temas problemáticos desde su lado.

¿Es seguro editar archivos como wp-config.php o .htaccess?

Sí, siempre y cuando hagas una copia de seguridad antes y solo modifiques líneas que entiendas. Si no estás seguro, pide ayuda a un técnico o al soporte de tu hosting.