Solución a errores comunes en WordPress: 500, conexión a base de datos y más
¿Tu web en WordPress se ha vuelto invisible de repente? Ver un error 500, una pantalla en blanco o el temido mensaje de «Error al conectar con la base de datos» puede ser frustrante, especialmente si no eres técnico. Pero no te preocupes: la mayoría de estos problemas tienen solución y, a menudo, puedes resolverlos tú mismo en pocos minutos.
En esta guía práctica, te explicamos paso a paso cómo solucionar los errores más comunes de WordPress, incluyendo el error 500, los fallos de conexión a la base de datos y otros clásicos. Usaremos herramientas que tienes a mano, como cPanel, Plesk o Syspanel (antes conocido como HestiaCP, accesible por el puerto 2106). Todo explicado de forma clara y sin tecnicismos.
¿Por qué aparecen estos errores en WordPress?
WordPress es un gestor de contenidos muy potente, pero su flexibilidad también lo hace sensible a pequeños fallos. Los errores más habituales suelen deberse a:
- Problemas con plugins o temas: Una actualización fallida, un plugin incompatible o un tema mal configurado.
- Límites de memoria del servidor: Si tu web crece, puede necesitar más recursos de los que tiene asignados.
- Archivos corruptos: Una mala actualización de WordPress o un archivo dañado.
- Datos de conexión incorrectos: La base de datos es el corazón de WordPress; si no se conecta bien, la web no funciona.
- Problemas de permisos de archivos: El servidor no puede leer o escribir ciertos archivos necesarios.
Vamos a ver cómo atacar cada uno de estos frentes.
Error 500 Internal Server Error: El más común y molesto
El error 500 es un «cajón desastre»: significa que algo falló en el servidor, pero no da más detalles. Sin embargo, la causa suele ser fácil de identificar.
Paso 1: Activa el modo de depuración de WordPress
Esto te mostrará el error real en lugar de la pantalla en blanco.
- Accede a tu panel de control de hosting (cPanel, Plesk o Syspanel). En Syspanel, usa la URL
tudominio.com:2106. - Busca el Administrador de Archivos (File Manager).
- Navega hasta la carpeta raíz de tu web (normalmente
public_htmlowww). - Localiza el archivo
wp-config.php. Si no lo ves, asegúrate de que estás viendo archivos ocultos (suele haber un botón de «Mostrar archivos ocultos»). - Descarga una copia de seguridad de este archivo por si acaso.
- Edita el archivo (clic derecho -> Editar).
- Busca la línea que dice
define('WP_DEBUG', false);. Si no existe, pégala justo antes de la línea que pone/* That's all, stop editing! Happy blogging. */. - Cámbiala por:
define('WP_DEBUG', true); define('WP_DEBUG_DISPLAY', true); - Guarda los cambios y recarga tu web. Ahora, en lugar del error 500, verás un mensaje más descriptivo (ej: «Fatal error: Call to undefined function...»). Ese mensaje te dirá qué archivo o plugin está fallando.
[WARNING] Una vez solucionado el error, vuelve a poner WP_DEBUG en false. Si lo dejas activo, los visitantes podrían ver mensajes de error internos.
Paso 2: Desactiva todos los plugins (sin entrar al panel)
Si el error te impide acceder al escritorio de WordPress, puedes desactivar los plugins desde el servidor.
- Ve al Administrador de Archivos de tu panel de control.
- Entra en la carpeta
wp-content. - Renombra la carpeta
pluginsaplugins_desactivados(o cualquier otro nombre). - Recarga tu web. Si el error desaparece, el problema era un plugin.
- Para identificar cuál, crea una nueva carpeta llamada
pluginsy mueve los plugins de uno en uno desdeplugins_desactivadosa la nueva carpeta, refrescando la web cada vez. Cuando el error vuelva a aparecer, ¡has encontrado al culpable!
Paso 3: Aumenta el límite de memoria de PHP
A veces, el error 500 aparece porque WordPress se queda sin memoria.
- Edita el archivo
wp-config.phpcomo en el paso 1. - Justo antes de la línea
/* That's all, stop editing!..., añade esta línea:define('WP_MEMORY_LIMIT', '256M'); - Guarda el archivo y recarga la web.
Si no funciona, el límite puede estar controlado por el servidor. En ese caso, contacta con tu proveedor de hosting o, si tienes acceso a la configuración de PHP en cPanel o Plesk (buscando «Select PHP Version» o «PHP Settings»), puedes subir el valor de memory_limit directamente.
Error de conexión a la base de datos: «Error establishing a database connection»
Este error significa que WordPress no puede hablar con la base de datos donde guarda tus artículos, usuarios y configuraciones. Es grave, pero suele tener una solución rápida.
Paso 1: Verifica los datos en wp-config.php
El archivo wp-config.php contiene las credenciales de la base de datos. Un cambio accidental o una migración mal hecha pueden romper la conexión.
- Accede a tu panel de control (cPanel, Plesk o Syspanel).
- Abre el Administrador de Archivos y localiza
wp-config.php. - Edítalo y busca estas líneas:
define('DB_NAME', 'nombre_base_datos'); define('DB_USER', 'usuario_base_datos'); define('DB_PASSWORD', 'contraseña_base_datos'); define('DB_HOST', 'localhost'); - Comprueba que estos datos sean correctos. Puedes obtenerlos desde tu panel de control:
- En cPanel: Busca «Bases de datos MySQL» y verás listadas tus bases de datos y usuarios.
- En Plesk: Ve a «Bases de datos» y selecciona la tuya para ver los detalles.
- En Syspanel: Busca «Bases de datos» y ahí aparecerán las credenciales.
- Presta atención al
DB_HOST. Normalmente eslocalhost, pero en algunos hostings puede ser algo comomysql.tudominio.com. Si lo cambiaste sin saber, ponlocalhostde nuevo.
Paso 2: Comprueba que la base de datos existe y no está corrupta
A veces, la base de datos se daña o se borra por error.
- Desde tu panel de control, entra al phpMyAdmin (suele ser un botón dentro de la sección de bases de datos).
- Selecciona tu base de datos (la que aparece en
DB_NAME). - Si ves el mensaje «No tables found» o «La base de datos parece estar vacía», es que los datos se han perdido. Necesitarás restaurar una copia de seguridad.
- Si las tablas aparecen pero sospechas que están corruptas, selecciona todas las tablas (marca la casilla de arriba del todo) y, en el menú desplegable «Con seleccionados:», elige «Reparar tabla». Esto suele arreglar pequeños daños.
Paso 3: Repara la base de datos desde wp-config.php
Si todo parece correcto pero sigue sin funcionar, puedes forzar una reparación.
- Añade esta línea a tu
wp-config.php, justo antes del/* That's all... */:define('WP_ALLOW_REPAIR', true); - Guarda el archivo.
- Accede a esta URL en tu navegador:
tudominio.com/wp-admin/maint/repair.php - Haz clic en «Reparar base de datos».
- IMPORTANTE: Una vez terminado, elimina esa línea de
wp-config.phpo cambiatrueporfalse. Si la dejas, cualquiera podría reparar (y potencialmente dañar) tu base de datos.
Otros errores comunes y soluciones rápidas
Error de sintaxis o «Parse error»
Suele aparecer al editar un archivo de tema o plugin y cometer un error (ej: olvidar un punto y coma).
- Solución: Accede al Administrador de Archivos, localiza el archivo que menciona el error (normalmente en
wp-content/themes/tu-tema/functions.php) y revierte los cambios. Si tienes una copia de seguridad, súbela. Si no, descarga el tema original desde el repositorio de WordPress y reemplaza el archivo dañado.
Pantalla blanca de la muerte (WSOD)
Es similar al error 500, pero sin ningún mensaje. Las causas son las mismas.
- Solución: Sigue los pasos del error 500: desactiva plugins (renombrando la carpeta), cambia al tema por defecto (renombrando la carpeta del tema actual en
wp-content/themes) y aumenta la memoria.
Error 404 en todas las páginas (excepto la portada)
Esto suele ocurrir después de cambiar la estructura de enlaces permanentes (permalinks).
- Solución: Ve a Ajustes -> Enlaces permanentes en tu escritorio de WordPress. Simplemente selecciona otra opción (ej: «Simple») y luego vuelve a seleccionar la que tenías (ej: «Nombre de la entrada»). Haz clic en «Guardar cambios». Esto regenera las reglas de reescritura. Si no puedes acceder al escritorio, edita el archivo
.htaccessen la raíz de tu web (desde el Administrador de Archivos) y añade estas líneas al principio:# 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
Error «No hay suficiente memoria disponible»
Similar al error 500 por memoria.
- Solución: Aumenta el límite de memoria en
wp-config.phpcomo vimos antes. Si no funciona, contacta con tu hosting para que suban el límite a nivel de servidor.
Preguntas frecuentes (FAQ)
¿Puedo perder mis datos al solucionar estos errores?
Si sigues los pasos correctamente (especialmente haciendo copias de seguridad antes de editar archivos), no deberías perder datos. Los errores más comunes afectan a la visualización, no al contenido de la base de datos. Sin embargo, si la base de datos está corrupta y no tienes backup, podrías perder información. Por eso es vital tener copias de seguridad periódicas.
¿Qué hago si no tengo acceso a cPanel, Plesk o Syspanel?
Algunos hostings muy básicos no dan acceso a paneles de control. En ese caso, tendrás que usar un cliente FTP (como FileZilla) para acceder a los archivos. El proceso es el mismo: descargar wp-config.php, editarlo y subirlo de nuevo. Para la base de datos, algunos hostings ofrecen phpMyAdmin desde su propia área de cliente.
¿Cómo accedo a Syspanel? ¿Es seguro?
Syspanel (el antiguo HestiaCP) se accede mediante la URL tudominio.com:2106. Es perfectamente seguro, siempre que uses una contraseña robusta. Desde ahí puedes gestionar archivos, bases de datos, dominios y más, igual que en cPanel.
¿Debo contratar a un profesional o puedo hacerlo yo mismo?
La mayoría de estos errores los puedes resolver tú mismo con esta guía. Si después de seguir todos los pasos el problema persiste, o si no te sientes cómodo editando archivos, entonces sí, contacta con el soporte técnico de tu hosting o con un desarrollador. Ellos tienen herramientas más avanzadas para diagnosticar problemas.
¿Cómo evito estos errores en el futuro?
- Mantén todo actualizado: WordPress, temas y plugins.
- Haz copias de seguridad frecuentes: La mayoría de los paneles (cPanel, Plesk, Syspanel) tienen herramientas para automatizarlas.
- Usa un tema y plugins de calidad y con buen soporte.
- No edites archivos directamente si no sabes lo que haces. Usa siempre un tema hijo para personalizaciones.
- Antes de actualizar un plugin o tema crítico, haz una copia de seguridad y prueba en un entorno de staging (si tu hosting lo permite).
Esperamos que esta guía te haya sido de ayuda. Recuerda que la paciencia y el método son tus mejores aliados. Si te encuentras con un error que no está aquí, no dudes en consultar la documentación oficial de WordPress o preguntar en foros especializados. ¡Buena suerte con tu web!
