Cómo solucionar errores comunes de WordPress (500, 502, 504, base de datos)
¿Tu WordPress ha decidido tomarse un descanso inesperado? No te preocupes, es más común de lo que crees y, en la gran mayoría de los casos, tiene solución.
Ver esos códigos de error en pantalla puede ser frustrante, pero respira hondo. Aquí estoy para acompañarte paso a paso, como si lo hiciéramos juntos frente al ordenador, para que entiendas qué está pasando y cómo arreglarlo.
Vamos a desglosar los errores más habituales: el temido error 500, el error 502, el error 504 y los problemas con la base de datos WordPress. Al final, tendrás un plan de acción claro para cada uno.
Entendiendo al enemigo: ¿Qué significa cada error?
Antes de lanzarnos a arreglar nada, es vital saber con qué estamos lidiando. Cada error nos da una pista sobre dónde está el problema.
Error 500 (Error Interno del Servidor)
Este es el más genérico y, a la vez, el más frustrante. Significa que algo ha salido mal en tu servidor, pero el servidor no te dice exactamente qué es. Es como si tu coche no arrancara y el mecánico solo te dijera "algo no va bien".
Causas más frecuentes:
- Un plugin o tema con un conflicto de código.
- Archivos con permisos incorrectos.
- Un archivo
.htaccesscorrupto. - Que se haya agotado la memoria PHP permitida.
Error 502 (Bad Gateway)
Este error significa que un servidor (el proxy) no recibió una respuesta válida de otro servidor (el servidor web). Piénsalo como una llamada telefónica donde el intermediario no logra comunicarse con la persona final.
Causas más frecuentes:
- El servidor web (Apache o Nginx) está caído o no responde.
- Problemas con la configuración del proxy inverso.
- Fallos temporales en el servicio de hosting (a veces, no es culpa tuya).
Error 504 (Gateway Timeout)
Aquí, el intermediario (proxy) sí se comunicó con el servidor final, pero este tardó demasiado en responder. Es como pedir una pizza y que el repartidor se quede dormido en el camino.
Causas más frecuentes:
- Un script (como un plugin) que tarda demasiado en ejecutarse.
- El servidor está sobrecargado por demasiado tráfico.
- Problemas con la configuración de tiempo de espera (timeout) del servidor.
Error de conexión con la base de datos
Este es muy claro. WordPress te dirá literalmente: "Error al establecer la conexión con la base de datos". Esto significa que tu sitio no puede leer ni escribir la información almacenada en su "cerebro" (la base de datos).
Causas más frecuentes:
- Las credenciales de acceso a la base de datos son incorrectas.
- La base de datos está corrupta o ha sido eliminada.
- El servidor de base de datos (MySQL/MariaDB) está caído.
- El archivo
wp-config.phptiene información errónea.
Tu Kit de Herramientas: Lo que Necesitas Antes de Empezar
Para la mayoría de las soluciones, necesitarás dos cosas:
- Acceso a tu Panel de Control de Hosting: Este es el lugar donde gestionas tu cuenta. Puede ser cPanel, Plesk, o si usas Syspanel, recuerda que el puerto de acceso es el 2106.
- Acceso por FTP o un Administrador de Archivos: Esto te permite ver y modificar los archivos de tu web directamente. Puedes usar programas como FileZilla o el administrador de archivos que viene integrado en tu panel de hosting.
[WARNING]: Antes de tocar nada, haz una copia de seguridad completa de tu sitio web (archivos y base de datos). Esto es tu red de seguridad. Si algo sale mal, podrás volver atrás sin perder nada.
Cómo Solucionar el Error 500 en WordPress
Este es el error más común, así que vamos a por él. Sigue estos pasos en orden, del más simple al más complejo.
Paso 1: Desactiva Todos los Plugins
La causa más habitual del error 500 es un plugin conflictivo. Para comprobarlo, necesitas desactivarlos todos.
-
Opción A (Desde el panel de WordPress): Si puedes acceder al escritorio de WordPress, ve a Plugins > Plugins instalados y desactiva todos. Si el error desaparece, reactívalos uno a uno hasta encontrar al culpable.
-
Opción B (Desde FTP/Administrador de archivos): Si no puedes acceder al panel, entra a tu servidor por FTP. Busca la carpeta
wp-content, y dentro, encuentra la carpetaplugins. Renómbrala aplugins_desactivados. Esto forzará a WordPress a desactivar todos los plugins a la vez, porque no podrá encontrar la carpeta.[TIP]: Al renombrar la carpeta, no borras nada. Solo cambias su nombre. WordPress creará una nueva carpeta
pluginsvacía. Cuando encuentres el plugin problemático, puedes eliminar la carpeta nueva y volver a ponerle el nombre original a la tuya.
Paso 2: Cambia al Tema por Defecto
A veces, el problema no es un plugin, sino el tema que estás usando.
- Ve a la carpeta
wp-contenty busca la carpetathemes. - Dentro, verás carpetas con los nombres de tus temas instalados (ej.
twentytwentyfour,mi-tema-personalizado). - Renombra la carpeta de tu tema activo (el que estás usando) a algo como
mi-tema-personalizado_desactivado.
WordPress, al no encontrar tu tema, usará automáticamente el tema por defecto que tenga instalado (como Twenty Twenty-Four). Si el error se soluciona, el problema es de tu tema.
Paso 3: Aumenta el Límite de Memoria PHP
A veces, el error 500 aparece porque tu sitio necesita más memoria de la que tiene asignada.
-
Busca el archivo
wp-config.phpen la raíz de tu instalación de WordPress. -
Ábrelo con un editor de texto plano (como el Bloc de notas).
-
Justo antes de la línea que dice
/* ¡Eso es todo, deja de editar! ¡Feliz blogging! */, añade esta línea:define('WP_MEMORY_LIMIT', '256M'); -
Guarda el archivo y sube los cambios a tu servidor.
Paso 4: Revisa los Permisos de Archivos y Carpetas
Los permisos incorrectos pueden provocar este error.
- En general, las carpetas deben tener permisos
755o750. - Los archivos deben tener permisos
644o640.
Puedes cambiar esto desde tu cliente FTP (clic derecho > "Permisos de archivo") o desde el administrador de archivos de tu hosting. Aplica esto a todas las carpetas y archivos de tu instalación de WordPress.
Paso 5: Revisa el Archivo .htaccess
Este archivo puede estar corrupto.
- Conéctate por FTP y busca el archivo
.htaccessen la raíz de tu WordPress. - Renómbralo a
.htaccess_viejo. - Ve a Ajustes > Enlaces permanentes en tu panel de WordPress (si puedes acceder) y haz clic en "Guardar cambios". Esto creará un archivo
.htaccessnuevo y limpio.
Cómo Solucionar el Error 502 en WordPress
El error 502 suele ser más un problema del servidor que de tu WordPress en sí. Pero hay cosas que puedes probar.
Paso 1: Reinicia el Servidor Web
A veces, un simple reinicio del servicio de Apache o Nginx soluciona el problema.
- Si tienes acceso a Syspanel (puerto 2106), busca la sección de "Servicios" o "Web Server".
- Desde ahí, puedes reiniciar el servicio. Si usas otro panel, busca la opción equivalente.
Paso 2: Limpia la Caché del Navegador y del Servidor
Una caché corrupta puede causar este error.
- Limpia la caché de tu navegador.
- Si tienes un plugin de caché (como W3 Total Cache o WP Super Cache), bórrala desde el panel de WordPress o desde el propio plugin.
Paso 3: Contacta con tu Proveedor de Hosting
Si los pasos anteriores no funcionan, el error 502 suele ser un problema del servidor que está fuera de tu control. Puede que un proceso esté bloqueado o que el servidor esté sobrecargado.
[INFO]: No dudes en contactar con el soporte técnico de tu hosting. Ellos tienen acceso directo a los servidores y pueden diagnosticar el problema mucho más rápido. Diles que tienes un error 502 y que ya has reiniciado el servidor web desde tu panel.
Cómo Solucionar el Error 504 en WordPress
Este error indica que algo está tardando demasiado.
Paso 1: Desactiva Plugins Conflictivos
Al igual que con el error 500, un plugin que hace una petición externa o ejecuta un proceso pesado puede causar un timeout.
- Sigue el Paso 1 de la solución del error 500 para desactivar todos los plugins y ver si el problema se soluciona.
Paso 2: Aumenta el Tiempo de Ejecución Máximo (Max Execution Time)
Puedes intentar darle más tiempo a PHP para que ejecute los scripts.
-
Añade esta línea a tu archivo
wp-config.php:set_time_limit(60); -
También puedes intentar añadirla al principio del archivo
.htaccess:php_value max_execution_time 60
Paso 3: Verifica el Estado de tu Servidor
Si tu web está recibiendo mucho tráfico o un script se está ejecutando en bucle, el servidor puede colapsarse.
- Revisa si hay algún plugin que esté haciendo "cron jobs" (tareas programadas) demasiado pesados.
- Considera optimizar tu base de datos (ver más abajo) para que las consultas sean más rápidas.
Cómo Solucionar los Errores de Base de Datos en WordPress
Este es un error crítico, pero muy solucionable.
Paso 1: Verifica tus Credenciales en wp-config.php
Este es el archivo más importante. Contiene la información de tu base de datos.
-
Conéctate por FTP y abre el archivo
wp-config.php. -
Busca estas líneas:
define('DB_NAME', 'nombre_de_tu_bd'); define('DB_USER', 'tu_usuario'); define('DB_PASSWORD', 'tu_contraseña'); define('DB_HOST', 'localhost'); -
Comprueba que estos datos sean correctos. Puedes verificar el nombre de la base de datos y el usuario desde tu panel de control de hosting (en la sección de "Bases de datos MySQL").
[WARNING]: Ten mucho cuidado al editar este archivo. Un solo carácter mal puesto puede romper tu web. Si no estás seguro de los datos, contacta con tu hosting.
Paso 2: Repara la Base de Datos
A veces, la base de datos se corrompe ligeramente. WordPress tiene una herramienta para repararla.
-
Añade esta línea a tu archivo
wp-config.php:define('WP_ALLOW_REPAIR', true); -
Guarda el archivo y visita 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 del archivo
wp-config.php. De lo contrario, cualquier persona podría acceder a esa herramienta de reparación.
Paso 3: Optimiza la Base de Datos (Si Puedes Acceder)
Si ya has solucionado el error y puedes acceder a WordPress, instala un plugin como WP-Optimize. Este plugin limpia y optimiza las tablas de tu base de datos, lo que puede prevenir futuros errores y acelerar tu web.
Paso 4: Contacta con tu Proveedor de Hosting
Si el error persiste, es muy probable que el problema sea que el servidor de base de datos (MySQL/MariaDB) esté caído o sobrecargado. Esto es algo que solo tu proveedor de hosting puede solucionar.
[TIP]: Si has llegado hasta aquí y el problema sigue, no te desesperes. Documenta todo lo que has intentado y contacta con el soporte de tu hosting. Diles los pasos que ya has seguido, para que ellos no pierdan tiempo y puedan centrarse en el problema real.
Preguntas Frecuentes (FAQ) Rápidas
¿Qué hago si no puedo acceder ni a mi panel de WordPress ni al FTP?
Contacta directamente con tu proveedor de hosting. Ellos tienen acceso de nivel raíz y pueden ver qué está pasando.
¿Cada cuánto debo hacer una copia de seguridad?
Idealmente, cada vez que hagas un cambio importante (actualizar un plugin, cambiar de tema, etc.). Como mínimo, una vez al mes. Muchos hostings ofrecen copias de seguridad automáticas.
¿Estos errores significan que he sido hackeado?
No necesariamente. Aunque un hackeo puede causar estos errores, la mayoría de las veces se deben a conflictos de código o problemas del servidor. Si sospechas de un hackeo, contacta con un profesional.
¿Puedo prevenir estos errores?
Sí, en gran medida. Mantén WordPress, tus temas y plugins siempre actualizados. Usa temas y plugins de fuentes confiables. Y no instales demasiados plugins que hagan lo mismo.
Espero que esta guía te haya sido de gran ayuda. Recuerda, la paciencia es clave. Ve paso a paso y, sobre todo, ¡no olvides las copias de seguridad! Si tienes alguna duda, déjala en los comentarios y estaré encantado de ayudarte.
