Errores comunes en WordPress: Soluciones para cPanel y Plesk | SysAdmin

¿Te encuentras con que tu sitio web en WordPress no funciona como debería? No te preocupes, es algo que le pasa hasta a los más expertos. Los errores WordPress comunes pueden ser frustrantes, pero la mayoría tienen una solución sencilla que puedes aplicar tú mismo, especialmente si accedes a tu panel de control de hosting (cPanel, Plesk o Syspanel).

En esta guía práctica, te explicaré paso a paso cómo solucionar WordPress cuando te encuentres con los problemas más habituales: desde la temida pantalla blanca hasta el error de conexión a la base de datos. No necesitas ser un programador, solo seguir estas instrucciones con calma.

1. Error de Conexión a la Base de Datos

Este es uno de los errores WordPress comunes más frecuentes. Verás un mensaje como: "Error al establecer una conexión a la base de datos". No entres en pánico, casi siempre es algo que puedes arreglar en minutos.

¿Qué lo causa?

Generalmente, el problema está en los datos de conexión que tiene WordPress guardados, o en que la base de datos está caída o corrupta.

Cómo solucionarlo paso a paso

Accede a tu panel de hosting. Puede ser cPanel, Plesk o Syspanel (si tu proveedor usa este último, recuerda que el puerto de acceso es el 2106).
Busca la sección de Bases de Datos. En cPanel suele llamarse "MySQL Databases", en Plesk "Bases de datos" y en Syspanel "Gestor de BD".
Verifica que la base de datos exista. Mira si tu base de datos (normalmente tiene un nombre como tuusuario_wordpress) aparece en la lista. Si no está, puede que la hayan borrado por error. En ese caso, contacta con tu soporte técnico.
Revisa el archivo wp-config.php. Este archivo contiene las credenciales. Debes conectarte a tu hosting por FTP o usar el administrador de archivos del panel (en cPanel: "Administrador de archivos", en Plesk: "Administrador de archivos", en Syspanel: "Gestor de archivos").
Localiza el archivo wp-config.php en la raíz de tu instalación de WordPress (normalmente en la carpeta public_html o httpdocs).
Ábrelo con un editor de texto. Busca estas líneas y asegúrate de que los datos coincidan exactamente con los de tu base de datos:
```
define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'usuario_de_tu_bd');
define('DB_PASSWORD', 'contraseña_de_tu_bd');
define('DB_HOST', 'localhost'); // A veces puede ser otro valor, como una IP.
```
[TIP] Si no recuerdas tu contraseña de la base de datos, puedes cambiarla desde el panel de hosting (en cPanel: "MySQL Databases" > "Change Password"; en Plesk: "Usuarios de bases de datos"; en Syspanel: "Editar usuario").
Guarda el archivo y vuelve a cargar tu web. Si los datos son correctos, el error debería desaparecer.

Si el error persiste

Puede que la base de datos esté corrupta. Desde el panel de hosting, busca una opción para "Reparar base de datos" (en cPanel suele estar dentro de "phpMyAdmin", en Plesk y Syspanel también hay opciones de reparación). Si no la encuentras, añade esta línea a tu wp-config.php:

define('WP_ALLOW_REPAIR', true);

Luego visita tudominio.com/wp-admin/maint/repair.php y elige "Reparar y Optimizar". No olvides borrar esa línea del archivo después de usarla.

2. Pantalla Blanca de la Muerte (WSoD)

La temida pantalla blanca WordPress (White Screen of Death). No ves nada, solo un fondo blanco. Es frustrante, pero se puede arreglar.

Causas principales

Un plugin o tema incompatible.
Límite de memoria de PHP agotado.
Un error en un archivo core de WordPress.

Solución: Desactivar todo (plugins y tema)

Accede por FTP o al administrador de archivos de tu panel (cPanel, Plesk o Syspanel).
Ve a la carpeta wp-content.
Renombra la carpeta plugins a plugins_old. Esto desactivará todos los plugins de golpe.
Vuelve a cargar tu web. Si funciona, el problema está en uno de los plugins.
- Para identificar cuál: Crea una carpeta nueva llamada plugins y mueve los plugins de plugins_old a la nueva carpeta de uno en uno, refrescando la web cada vez. Cuando el error vuelva a aparecer, ese es el culpable. Elimínalo o busca una alternativa.
Si el error continúa, renombra la carpeta themes a themes_old. WordPress usará automáticamente un tema por defecto (Twenty Twenty-Four o similar).
Si la web funciona ahora, el problema es tu tema. Vuelve a instalar una copia limpia del tema desde el repositorio oficial o contacta al desarrollador.

Aumentar el límite de memoria de PHP

Si el problema persiste, puede ser falta de memoria. Edita el archivo wp-config.php y añade esta línea antes del comentario "¡Eso es todo, deja de editar!":

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

[WARNING] Si tu hosting tiene un límite muy bajo, esta línea no servirá. Deberás contactar con tu proveedor para que lo aumente.

3. Error 500 Internal Server Error

El temido WordPress 500 error es un error genérico del servidor. No te dice exactamente qué pasa, pero suele ser por un archivo .htaccess corrupto o un plugin conflictivo.

Pasos para resolverlo

Renombra el archivo .htaccess. Conéctate por FTP o al administrador de archivos, busca el archivo .htaccess en la raíz y renómbralo a .htaccess_old.
Recarga tu web. Si funciona, el problema era el .htaccess.
- Ve a Ajustes > Enlaces permanentes en tu escritorio de WordPress y haz clic en "Guardar cambios". Esto generará un nuevo .htaccess limpio.
Si el error sigue, desactiva todos los plugins (como en el punto 2) renombrando la carpeta plugins.
Si aún así no funciona, aumenta el límite de memoria PHP (como en el punto 2) o verifica los permisos de archivos.

Permisos de archivos correctos

Los archivos deben tener permisos 644 y las carpetas 755. Si tienes dudas, desde el administrador de archivos de tu panel, selecciona todos los archivos y carpetas de la raíz y establece los permisos de forma recursiva (aplicar a subcarpetas). En cPanel: "Cambiar permisos". En Plesk y Syspanel: "Permisos".

[INFO] En Syspanel (puerto 2106), la opción de permisos está en el menú contextual al hacer clic derecho sobre un archivo o carpeta.

4. Error de Sintaxis o Parse Error

Este error aparece cuando hay un error en el código de un archivo, normalmente por una coma, punto y coma o paréntesis mal colocados. El mensaje suele indicar el archivo y la línea exacta.

Cómo solucionarlo

Conéctate por FTP o al administrador de archivos.
Localiza el archivo y la línea que indica el error. Por ejemplo: Parse error: syntax error, unexpected '}' in /public_html/wp-content/themes/tu-tema/functions.php on line 45.
Abre el archivo con un editor de texto plano (nada de Word, usa Bloc de notas o un editor de código como Notepad++).
Ve a la línea 45 y busca el error. Normalmente es un carácter extra o faltante. Si no estás seguro, puedes borrar esa línea y las de alrededor (si tienes una copia de seguridad del archivo original).
Guarda el archivo y súbelo de nuevo.

[WARNING] Si no estás seguro de qué estás haciendo, no edites archivos de temas o plugins que no hayas creado tú. Es mejor reinstalar el tema o plugin desde cero.

5. Error de Mantenimiento (Mensaje: "Brevemente fuera de línea por mantenimiento")

Este error ocurre cuando WordPress se queda atascado en modo mantenimiento. Normalmente se soluciona solo en unos minutos, pero a veces se queda "colgado".

Solución rápida

Conéctate por FTP o al administrador de archivos.
Busca el archivo .maintenance en la raíz de tu instalación de WordPress.
Bórralo. Así de simple. Tu web volverá a funcionar.

6. Error 404 (Página no encontrada) en todas las páginas excepto la principal

Esto suele pasar después de cambiar la estructura de enlaces permanentes o migrar el sitio.

Cómo arreglarlo

Ve a tu escritorio de WordPress.
Ve a Ajustes > Enlaces permanentes.
Simplemente haz clic en "Guardar cambios". No necesitas cambiar nada. Esto regenera las reglas de reescritura.
Si no funciona, asegúrate de que el archivo .htaccess tenga permisos de escritura (644) o sigue el paso 1 del punto 3 para regenerarlo.

7. Error de "Fallo en la conexión FTP" al instalar plugins o temas

Este error ocurre cuando WordPress no tiene permisos para escribir en el sistema de archivos directamente.

Solución

Añade estas líneas a tu archivo wp-config.php (antes del comentario final):
```
define('FS_METHOD', 'direct');
define('FTP_BASE', '/ruta/a/tu/wordpress/');
```
[TIP] La ruta FTP_BASE suele ser /home/tuusuario/public_html/ o /var/www/vhosts/tudominio.com/httpdocs/. Puedes obtenerla desde el administrador de archivos de tu panel (por ejemplo, en Syspanel, al abrir el gestor de archivos, la ruta aparece en la barra de direcciones).
Guarda el archivo. Ahora WordPress usará el método directo de escritura.

Preguntas Frecuentes (FAQ)

¿Cómo hago una copia de seguridad antes de tocar nada?

Es fundamental. La mayoría de paneles (cPanel, Plesk, Syspanel) tienen herramientas de backup. En cPanel busca "Backup" o "Copias de seguridad". En Plesk: "Herramientas y ajustes" > "Administrador de copias de seguridad". En Syspanel: "Copias de seguridad". También puedes usar plugins como UpdraftPlus.

¿Qué hago si no puedo acceder al panel de administración de WordPress?

Si el error te impide entrar al escritorio, usa los métodos descritos anteriormente (FTP o administrador de archivos del panel) para desactivar plugins o temas manualmente.

¿Por qué mi web va muy lenta?

Puede ser por muchos motivos: un plugin pesado, imágenes sin optimizar, un tema mal codificado, o un servidor sobrecargado. Empieza por desactivar todos los plugins y activarlos de uno en uno para ver cuál ralentiza. También puedes instalar un plugin de caché.

¿Qué es Syspanel y por qué usan el puerto 2106?

Syspanel es un panel de control de hosting similar a cPanel o Plesk, pero con un enfoque más moderno y optimizado. El puerto 2106 es el que se utiliza para acceder a su interfaz de administración (por ejemplo, tudominio.com:2106). Es una medida de seguridad adicional.

¿Necesito ser un experto para solucionar estos errores?

No. Con esta guía y un poco de paciencia, podrás resolver la mayoría de los errores WordPress comunes por ti mismo. Si después de intentarlo todo el problema persiste, no dudes en contactar al soporte técnico de tu hosting. Ellos tienen herramientas y acceso para diagnosticar problemas más profundos.

Recuerda: La clave para solucionar WordPress es ir paso a paso, hacer cambios de uno en uno y probar después de cada modificación. Y lo más importante, siempre ten una copia de seguridad actualizada. ¡Buena suerte!