Errores comunes de WordPress y cómo solucionarlos (cPanel, Plesk)
¿Tu WordPress ha decidido dejar de funcionar sin previo aviso? Respira hondo. Es algo que le pasa a todo el mundo, incluso a los más expertos. La buena noticia es que la gran mayoría de los errores wordpress tienen una solución clara y, en muchos casos, puedes arreglarlos tú mismo en minutos desde tu panel de control (ya sea cPanel, Plesk o Syspanel).
En esta guía extensa y práctica, vamos a desgranar los problemas más comunes que aparecen en WordPress, te explicaré por qué ocurren y, lo más importante, te daré el paso a paso para solucionar errores wordpress sin necesidad de ser un programador. Vamos a ello.
El temido "Error al establecer conexión con la base de datos"
Este es, sin duda, uno de los wordpress problemas más frecuentes y aterradores. Ves la pantalla blanca con ese mensaje y sientes que todo se ha perdido. Pero no es así. Este error significa que WordPress no puede comunicarse con tu base de datos, donde se guardan todas tus entradas, páginas y configuraciones.
¿Por qué ocurre? Las causas más comunes son que las credenciales de acceso a la base de datos hayan cambiado, que el servidor de la base de datos esté caído o que los archivos de configuración se hayan corrompido.
Solución paso a paso
Vamos a revisar la configuración. Necesitas acceder a tu panel de control (cPanel o Plesk) y seguir estos pasos:
- Accede a tu panel de control: Entra con tus credenciales de hosting.
- Busca el gestor de archivos: En cPanel suele llamarse "Administrador de archivos" o "File Manager". En Plesk, busca "Administrador de archivos" dentro de tu dominio.
- Localiza el archivo
wp-config.php: Está en la raíz de tu instalación de WordPress (normalmente enpublic_html). - Edita el archivo: Haz clic derecho sobre él y selecciona "Editar" o "Edit".
- Revisa las líneas de conexión: Busca estas líneas y verifica que los datos sean correctos:
DB_NAME(nombre de la base de datos)DB_USER(usuario de la base de datos)DB_PASSWORD(contraseña del usuario)DB_HOST(normalmente eslocalhost, pero a veces es un servidor específico comomysql.tudominio.com).
Si no estás seguro de cuáles son tus credenciales, ve a la sección "Bases de datos MySQL" en cPanel o "Bases de datos" en Plesk. Ahí podrás ver los usuarios y sus permisos. Si es necesario, puedes cambiar la contraseña y actualizarla también en el archivo wp-config.php.
[TIP] Si usas Syspanel, el acceso al panel es a través del puerto 2106. La estructura de archivos es similar, solo cambia la interfaz, pero la lógica es idéntica.
La pantalla blanca de la muerte (WSOD)
Otro clásico. Estás navegando por tu web y, de repente, todo se vuelve blanco. Sin mensajes, sin nada. Esto es la Pantalla Blanca de la Muerte (WSOD). Ocurre principalmente por un error de PHP en algún tema o plugin, o por un límite de memoria agotado.
Cómo diagnosticar y arreglar la WSOD
Lo primero es intentar ver el error real. WordPress a veces lo oculta. Para ello, activaremos el modo de depuración (debug).
- Edita
wp-config.php: Igual que en el paso anterior, localiza y edita el archivo en tu panel (cPanel, Plesk o Syspanel). - Busca la línea de debug: Busca
WP_DEBUGy cámbiala atrue. Si no existe, añádela antes de la línea que dice/* That's all, stop editing! Happy publishing. */.define('WP_DEBUG', true);
- Guarda el archivo y recarga tu web: Ahora verás un mensaje de error específico, como "Error fatal: ... en /ruta/al/archivo.php en la línea X".
- Identifica al culpable: Ese mensaje te dirá si el problema es un plugin o un tema. Si menciona un plugin, desactívalo. Si menciona el tema, cámbialo por uno por defecto (como Twenty Twenty-Four).
Solución rápida si no ves el error
Si activar el debug no te muestra nada, el problema suele ser de memoria. Añade esta línea a tu wp-config.php:
define('WP_MEMORY_LIMIT', '256M');
Esto aumentará el límite de memoria para WordPress y solucionará muchos casos de pantalla blanca.
[WARNING] Si no puedes acceder al administrador (
/wp-admin), no te preocupes. Puedes desactivar todos los plugins renombrando la carpetawp-content/pluginsawp-content/plugins_offdesde el Administrador de Archivos. Esto forzará a WordPress a no cargar ningún plugin y te permitirá entrar al panel.
Error 500: Error interno del servidor
Este es un error genérico que indica que algo salió mal en el servidor, pero no te dice qué. Es como si el servidor dijera "no puedo procesar esto". Las causas suelen ser un archivo .htaccess corrupto, un plugin incompatible o un problema de permisos.
Pasos para solucionar el error 500
Vamos a ir de lo más simple a lo más complejo.
-
Revisa el archivo
.htaccess: Este archivo es crucial para el funcionamiento de los enlaces permanentes y la seguridad. A veces se corrompe.- Ve al Administrador de Archivos.
- Activa la opción de "Mostrar archivos ocultos" (suele estar en la esquina superior derecha).
- Busca el archivo
.htaccessen la raíz. Si existe, renómbralo a.htaccess_backup. - Ve a tu panel de WordPress (si puedes) y en "Ajustes" > "Enlaces permanentes", haz clic en "Guardar cambios". Esto creará un nuevo
.htaccesslimpio.
-
Aumenta el límite de memoria: Al igual que en el caso anterior, añade la línea
define('WP_MEMORY_LIMIT', '256M');a tuwp-config.php. -
Revisa los permisos de archivos: Los permisos incorrectos pueden causar este error. Los archivos deben tener permiso
644y las carpetas755.- Selecciona todos los archivos y carpetas en la raíz.
- Haz clic derecho y elige "Permisos" o "Cambiar permisos".
- Asegúrate de que los archivos sean
644y las carpetas755. No marques la casilla de "recursivo" si no estás seguro de lo que haces, o hazlo solo para archivos y luego solo para carpetas.
[INFO] En Plesk, la gestión de archivos y permisos está en la pestaña "Administrador de archivos" dentro de tu dominio. En Syspanel, recuerda que el acceso es por el puerto 2106 y la interfaz es muy intuitiva.
Problemas con los enlaces permanentes (404 en páginas internas)
Entras a tu web y la portada funciona, pero al hacer clic en una entrada, te da un error 404 "No encontrado". Esto es un problema de enlaces permanentes (Permalinks). Normalmente ocurre después de migrar la web o cambiar la estructura de los enlaces.
Solución para los enlaces rotos
Este es uno de los wordpress problemas más fáciles de arreglar.
- Accede a tu panel de administración de WordPress: Ve a
tudominio.com/wp-admin. - Ve a Ajustes > Enlaces permanentes (Permalinks).
- Selecciona la opción "Estructura simple" (Plain) y haz clic en "Guardar cambios".
- Vuelve a seleccionar tu estructura original (por ejemplo, "Nombre de la entrada" o la que tenías antes) y haz clic en "Guardar cambios" de nuevo.
Este simple proceso regenera las reglas de reescritura y soluciona el error 404. Si no funciona, revisa que el archivo .htaccess tenga permisos de escritura (644) o repite el paso de renombrarlo y guardar los enlaces permanentes.
"Se ha excedido el límite de ejecución" (Fatal error: Maximum execution time)
Este error aparece cuando un script tarda demasiado en ejecutarse. Es muy común al instalar plugins pesados o al realizar copias de seguridad. El límite por defecto suele ser de 30 segundos, pero algunos procesos necesitan más.
Cómo aumentar el tiempo de ejecución
Tienes dos opciones: desde el panel de control o editando un archivo.
Opción A: Desde cPanel/Plesk/Syspanel
Busca la sección "Configuración de PHP" o "PHP Settings". Ahí podrás cambiar el valor de max_execution_time a 300 (5 minutos) o más.
Opción B: Editando el archivo wp-config.php
Añade esta línea al final del archivo, antes de la línea de cierre:
set_time_limit(300);
[TIP] Si tu proveedor de hosting no te deja cambiar estos valores, contacta con su soporte. Es una petición muy común y suelen hacerlo sin problema.
El plugin o tema que no se actualiza o da error
A veces, al intentar actualizar un plugin o tema, te sale un error de "Descarga fallida" o "No se pudo crear el directorio". Esto suele ser un problema de permisos de escritura en la carpeta wp-content.
Solución de permisos
- Ve al Administrador de Archivos en tu panel de control.
- Navega a
wp-content. - Cambia los permisos de la carpeta
wp-contenta755temporalmente. Si ya lo está, pásala a775y prueba de nuevo la actualización. - Una vez actualizado, vuelve a poner los permisos a
755por seguridad.
[WARNING] No dejes los permisos en
775permanentemente, ya que es un riesgo de seguridad. Es solo una solución temporal para la actualización.
Cómo prevenir futuros errores wordpress
Más vale prevenir que curar. Aquí tienes una lista de buenas prácticas para evitar estos sustos en el futuro:
- Mantén todo actualizado: Actualiza siempre el núcleo de WordPress, los temas y los plugins. Las actualizaciones corrigen errores y vulnerabilidades de seguridad.
- Haz copias de seguridad periódicas: Es la regla de oro. Puedes usar plugins como UpdraftPlus o hacerlas desde tu panel de control (cPanel suele tener "Backup" o "Copias de seguridad").
- Elige plugins y temas de calidad: No instales cualquier cosa. Lee las reseñas y asegúrate de que sean compatibles con tu versión de WordPress.
- Desactiva los plugins que no uses: Cada plugin activo es un potencial punto de conflicto y una carga para tu servidor.
- Anota tus cambios: Si vas a hacer un cambio grande, como actualizar un tema, anota qué has hecho para poder revertirlo si es necesario.
Preguntas frecuentes (FAQ) sobre errores de WordPress
¿Por qué mi WordPress se pone en blanco?
La WSOD es un error de PHP. Puede ser por un plugin o tema con código defectuoso o por falta de memoria. Revisa el wp-config.php para ver el error exacto o aumenta el límite de memoria.
¿Cómo puedo acceder a mi WordPress si no puedo entrar al administrador?
Puedes desactivar todos los plugins renombrando la carpeta wp-content/plugins a wp-content/plugins_off desde el Administrador de Archivos de tu cPanel, Plesk o Syspanel. También puedes cambiar el tema por uno por defecto renombrando la carpeta del tema activo en wp-content/themes.
¿Qué significa el error 500 en WordPress?
Es un error genérico del servidor. Las causas más comunes son un archivo .htaccess corrupto o un plugin incompatible. Sigue los pasos de la sección correspondiente para diagnosticarlo.
¿Es lo mismo cPanel que Plesk?
No, son dos paneles de control de hosting diferentes, pero ambos hacen lo mismo: te permiten gestionar tus archivos, bases de datos, correos, etc. La interfaz es distinta, pero las opciones son equivalentes.
¿Qué hago si nada de esto funciona?
Si has probado todos los pasos y el error persiste, contacta con tu proveedor de hosting. Ellos tienen acceso a los logs del servidor y pueden ver el error exacto. Es posible que haya un problema en el servidor que solo ellos puedan solucionar.
Espero que esta guía te haya sido de gran ayuda. Recuerda que los errores wordpress son parte del día a día de cualquier webmaster, pero con paciencia y estas soluciones, podrás resolverlos sin pánico. ¡Nos leemos en la próxima!
