Deja tu email para unirte a la lista de espera de WP Insider

WP Insider

Solicita tu revisión gratuita

LM: Revisión

Solicita tu diagnóstico gratuito

LM: Análisis

Portada » Blog » Problemas WordPress » Error establishing a database connection en WordPress: causas y solución

Error establishing a database connection en WordPress: causas y solución

Pocas cosas asustan más a un propietario de web que encontrarse con la pantalla en blanco y ese mensaje: «Error establishing a database connection».

De un momento a otro, tu web ha dejado de funcionar. No solo tú — todos tus visitantes ven ese error. Y si tienes una tienda WooCommerce, cada minuto que pasa son ventas perdidas.

La buena noticia: tu contenido no ha desaparecido. Está en la base de datos, simplemente WordPress no puede acceder a ella.

¿Necesitas reparar tu WordPress? Descubre nuestro servicio de reparación WordPress y recupera el funcionamiento de tu web lo antes posible.

Qué significa exactamente este error

WordPress almacena absolutamente todo en una base de datos MySQL: posts, páginas, configuración de plugins, ajustes del tema, usuarios… Lo único que no está ahí son los archivos de medios y los archivos de código del core, temas y plugins.

Cada vez que alguien visita tu web, WordPress ejecuta una conexión a esa base de datos para recuperar el contenido y mostrárselo al visitante. Cuando esa conexión falla, WordPress no puede mostrar nada — ni el frontend ni el panel de administración /wp-admin.

El resultado es una pantalla completamente en blanco con una sola línea de texto.

Importante: si tienes caché activa, es posible que los visitantes no vean el error inmediatamente. La web seguirá sirviéndose desde caché hasta que expire. Pero en cuanto caduque, todos verán el error.

Por qué ocurre: las causas más habituales

1. Credenciales incorrectas en wp-config.php

Es la causa más común, especialmente después de una migración a un nuevo hosting. El archivo wp-config.php contiene los datos de conexión: nombre de la base de datos, usuario, contraseña y host. Si alguno no coincide con los del hosting, la conexión falla.

2. El servidor MySQL no responde

El servidor de base de datos tiene un límite de conexiones simultáneas. Si tu web recibe un pico de tráfico o hay procesos en bucle, puede saturarse y empezar a denegar conexiones. En hostings compartidos esto es más frecuente porque los recursos son limitados.

3. Base de datos corrupta

Los plugins que se instalan y desinstalan constantemente, fallos del servidor o interrupciones en mitad de una escritura pueden corromper tablas de la base de datos. Si además del error ves el mensaje «Una o más tablas de la base de datos no están disponibles», es casi seguro que es corrupción.

4. Archivos core de WordPress dañados

Una actualización fallida, un hackeo o una edición incorrecta de archivos del core puede romper la conexión. WordPress no puede inicializar correctamente y falla antes de llegar a conectar con la base de datos.

5. Migración mal ejecutada

Si has movido la web a un nuevo dominio o servidor y no has actualizado correctamente las URLs en la base de datos, WordPress puede entrar en bucles de redirección o directamente no arrancar.

Cómo intentar solucionarlo paso a paso

Paso 1 — Verifica las credenciales en wp-config.php

Accede por FTP o desde el gestor de archivos del hosting y abre wp-config.php. Comprueba que estos cuatro valores coinciden exactamente con los de tu panel de control de hosting:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');

El valor de DB_HOST suele ser localhost, pero algunos hostings usan una dirección diferente. Consulta tu panel.

Paso 2 — Comprueba si el servidor MySQL está activo

Entra en el panel de tu hosting y verifica que el servidor de base de datos está funcionando. Si está caído, es problema del hosting — contacta con su soporte.

Paso 3 — Intenta reparar la base de datos

Añade esta línea al final de tu wp-config.php justo antes de /* That's all, stop editing! */:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y accede a tudominio.com/wp-admin/maint/repair.php. Ejecuta la reparación. Una vez terminado, elimina esa línea del wp-config.php.

Paso 4 — Desactiva los plugins temporalmente

Accede por FTP a /wp-content/plugins/ y renombra la carpeta a plugins_desactivados. Si la web vuelve, uno de los plugins era el culpable. Renombra la carpeta de vuelta y actívalos uno a uno para identificar cuál falla.

Paso 5 — Restaura desde backup

Si nada funciona y tienes un backup reciente, restaura. Es la vía más rápida y segura cuando el problema es corrupción grave o archivos dañados.

Scroll al inicio