Error al establecer conexión con la base de datos en WordPress

Entras en tu web y aparece un mensaje seco, sin diseño, sin menú y sin demasiadas explicaciones: “Error al establecer conexión con la base de datos”.

Cuando ocurre esto, WordPress no puede cargar la web porque no consigue comunicarse correctamente con la base de datos. Y como ahí están guardadas las entradas, páginas, usuarios, ajustes, pedidos, formularios y buena parte de la configuración, la web se queda bloqueada.

El error puede asustar bastante, pero no siempre significa que hayas perdido la web. A veces se debe a una contraseña cambiada, un dato mal puesto en wp-config.php, una caída temporal de MySQL, un problema del hosting o una migración mal terminada.

Qué significa “Error al establecer conexión con la base de datos”

WordPress funciona con archivos y base de datos. Los archivos contienen el núcleo de WordPress, plugins, temas, imágenes y código. La base de datos guarda el contenido y muchos ajustes internos.

Cuando WordPress carga una página, necesita conectarse a esa base de datos. Si no puede hacerlo, muestra el mensaje de error.

En la práctica, este aviso significa una cosa muy concreta: WordPress está intentando hablar con la base de datos, pero no lo consigue.

Por qué aparece este error en WordPress

Hay varias causas posibles. Algunas son sencillas de corregir y otras requieren revisar el servidor o la base de datos con más calma.

Causa posible	Qué suele ocurrir
Datos incorrectos en wp-config.php	WordPress tiene mal el nombre de la base de datos, usuario, contraseña o servidor.
Contraseña de la base de datos cambiada	El usuario existe, pero la contraseña guardada en WordPress ya no coincide.
Base de datos caída	MySQL o MariaDB no responde, está parado o saturado.
Usuario sin permisos	El usuario de la base de datos no tiene permisos suficientes para acceder.
Migración incompleta	La web se ha movido de servidor y no se han actualizado bien los datos de conexión.
Hosting saturado	El servidor se queda sin recursos o limita conexiones a la base de datos.
Base de datos dañada	Alguna tabla puede estar corrupta o necesitar reparación.

Antes de tocar cosas al azar, conviene pensar qué pasó justo antes de que apareciera el error: una migración, un cambio de hosting, una restauración, una actualización, un cambio de contraseña o una caída del servidor.

Paso 1: revisa el archivo wp-config.php

El archivo wp-config.php está en la raíz de la instalación WordPress. Es uno de los archivos más importantes porque contiene, entre otras cosas, los datos que WordPress usa para conectar con la base de datos.

Lo encontrarás en la misma carpeta donde suelen estar:

• wp-admin
• wp-content
• wp-includes
• wp-config.php

Dentro de ese archivo verás algo parecido a esto:

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

Estos cuatro datos deben coincidir exactamente con la base de datos del hosting.

Qué significa cada dato de conexión

Para revisar el error con orden, conviene entender qué hace cada línea.

Dato	Qué indica	Qué revisar
DB_NAME	Nombre de la base de datos.	Que exista en el hosting y que esté escrito igual.
DB_USER	Usuario que accede a la base de datos.	Que el usuario exista y esté asignado a esa base de datos.
DB_PASSWORD	Contraseña del usuario de base de datos.	Que no se haya cambiado y que no haya errores de comillas o caracteres.
DB_HOST	Servidor donde está la base de datos.	Normalmente es localhost, pero algunos hostings usan otro valor.

Un solo carácter mal escrito puede dejar la web sin conexión. Revisa espacios, comillas, mayúsculas, guiones, prefijos y contraseñas copiadas con caracteres raros.

Paso 2: comprueba que la base de datos existe

Desde el panel del hosting, Plesk, cPanel o phpMyAdmin, comprueba que la base de datos indicada en DB_NAME existe realmente.

Esto es especialmente importante si el error aparece después de:

• migrar la web a otro servidor;
• restaurar una copia;
• cambiar de hosting;
• duplicar una instalación;
• mover la web desde un entorno de pruebas;
• importar una base de datos manualmente.

Puede pasar que los archivos estén en el servidor correcto, pero la base de datos no se haya importado, tenga otro nombre o no esté asociada al usuario adecuado.

Paso 3: revisa usuario y permisos de la base de datos

Que el usuario exista no siempre significa que pueda acceder a la base de datos. Debe tener permisos suficientes.

En el panel del hosting revisa:

• que el usuario de base de datos exista;
• que esté asignado a la base de datos correcta;
• que tenga permisos para leer y escribir;
• que la contraseña coincida con la de wp-config.php;
• que no se haya creado otro usuario durante una migración.

Si cambias la contraseña desde el panel del hosting, recuerda actualizar también DB_PASSWORD en wp-config.php.

Paso 4: comprueba DB_HOST

En muchas instalaciones WordPress, DB_HOST es:

localhost

Pero no siempre. Algunos proveedores usan un servidor de base de datos diferente, por ejemplo:

mysql.tudominio.com

o un hostname concreto del proveedor.

Si has cambiado de hosting o has migrado la web, este dato puede no coincidir. Una web puede tener bien el nombre de la base, el usuario y la contraseña, pero fallar por tener mal el servidor de base de datos.

Paso 5: revisa si MySQL o MariaDB está caído

A veces el problema no está en WordPress. Está en el servidor de base de datos.

Puede que MySQL o MariaDB esté parado, saturado o con demasiadas conexiones abiertas. En hosting compartido, también puede haber una incidencia temporal del proveedor.

Señales de que puede ser un problema de servidor:

• El error aparece sin haber tocado nada.
• Varias webs del mismo hosting fallan a la vez.
• El panel del hosting va lento o no carga.
• phpMyAdmin no conecta.
• El proveedor informa de incidencia.
• El error aparece y desaparece solo.

En ese caso, antes de modificar archivos, conviene revisar el estado del hosting o contactar con soporte.

Hosting y base de datos: por qué importa el alojamiento

Una web WordPress depende mucho del servidor. Si el hosting tiene bases de datos lentas, límites muy ajustados, pocas copias o soporte complicado, un error de conexión puede tardar más en resolverse.

Para una web profesional conviene usar un alojamiento que tenga:

• soporte técnico ágil;
• copias de seguridad;
• phpMyAdmin o herramienta similar;
• gestión clara de bases de datos;
• versiones actualizadas de PHP y MySQL/MariaDB;
• recursos suficientes para WordPress;
• opciones de restauración.

Error después de migrar WordPress

Una de las situaciones más habituales es ver este error justo después de mover una web de servidor.

En una migración pueden fallar varias cosas:

• la base de datos no se ha importado;
• el nombre de la base de datos ha cambiado;
• el usuario de base de datos es diferente;
• la contraseña no coincide;
• DB_HOST ya no es localhost;
• los archivos pertenecen a una web y la base de datos a otra;
• la importación quedó incompleta.

Si el error aparece justo después de una migración, revisa primero wp-config.php y la base de datos importada. Muchas veces el fallo está ahí.

Error después de restaurar una copia

Restaurar una copia también puede provocar este error si la restauración no se ha hecho completa o si archivos y base de datos no pertenecen al mismo momento.

Por ejemplo:

• se restauran archivos, pero no la base de datos;
• se restaura una base de datos antigua con otros datos;
• wp-config.php apunta a una base que ya no existe;
• el usuario no tiene permisos;
• la restauración del hosting queda a medias.

En este caso hay que revisar qué copia se restauró, de qué fecha es y si incluye archivos y base de datos.

Error por base de datos dañada

En algunos casos, la conexión existe, pero la base de datos tiene tablas dañadas o errores internos. No es lo más habitual, pero puede ocurrir después de caídas, restauraciones, problemas de disco o interrupciones del servidor.

WordPress permite activar una herramienta de reparación añadiendo temporalmente esta línea en wp-config.php:

define('WP_ALLOW_REPAIR', true);

Después se puede acceder a:

https://tudominio.com/wp-admin/maint/repair.php

Desde ahí se puede intentar reparar la base de datos.

Antes de reparar, conviene tener copia de seguridad. Si la base de datos está dañada, no es buena idea improvisar.

Error en WooCommerce: más cuidado todavía

Si el error aparece en una tienda WooCommerce, el problema es más delicado. La base de datos guarda pedidos, clientes, productos, cupones, ajustes, estados de pago y mucha información importante.

Antes de restaurar una copia o tocar la base de datos, revisa bien:

• si hay pedidos recientes;
• si la copia incluye base de datos y archivos;
• si se perderían ventas al restaurar;
• si el error viene del servidor o de credenciales;
• si se puede reparar sin volver atrás;
• si hay logs del hosting o de WooCommerce que ayuden.

En tiendas online, restaurar una copia antigua puede recuperar la web, pero también borrar pedidos recientes. Hay que actuar con más calma.

Cómo comprobar si el error es temporal

A veces el error aparece durante unos minutos y luego desaparece. Esto puede ocurrir por saturación del servidor, mantenimiento del hosting o un pico de conexiones a la base de datos.

Si ocurre de forma puntual, puede ser una incidencia aislada. Si se repite, hay que investigar.

Revisa:

• hora a la que ocurre;
• si coincide con copias de seguridad;
• si coincide con importaciones o tareas cron;
• si hay picos de tráfico;
• si el hosting limita conexiones;
• si algún plugin hace consultas pesadas;
• si hay errores repetidos en logs.

Un error que aparece y desaparece puede ser más difícil de diagnosticar, pero no conviene ignorarlo si se repite.

Qué no deberías hacer

Cuando la web está caída, es fácil empezar a tocar cosas con prisa. Pero algunas acciones pueden complicar el problema.

• No borres la base de datos.
• No cambies wp-config.php sin guardar copia.
• No restaures una copia antigua sin revisar qué perderías.
• No cambies todas las contraseñas sin anotar qué has modificado.
• No elimines usuarios de base de datos sin saber cuál usa WordPress.
• No importes una base de datos encima de otra sin copia previa.
• No mezcles archivos de una web con base de datos de otra.

Ejemplo práctico: web migrada y base de datos mal configurada

Imagina que mueves una web WordPress de un hosting antiguo a uno nuevo. Subes los archivos por FTP, importas la base de datos y apuntas el dominio al nuevo servidor.

Al entrar en la web aparece:

Error al establecer conexión con la base de datos.

En ese caso, el proceso lógico sería:

1. Entrar al panel del nuevo hosting.
2. Comprobar el nombre real de la base de datos.
3. Revisar el usuario asignado a esa base.
4. Crear o confirmar la contraseña.
5. Editar wp-config.php con esos datos.
6. Confirmar si DB_HOST debe ser localhost u otro valor.
7. Probar la web.
8. Revisar si hay errores adicionales después de conectar.

Muchas veces, con corregir esos datos, la web vuelve a cargar.

Checklist para solucionar el error de conexión con la base de datos

Antes de darlo por resuelto, revisa esta lista:

• ¿Tienes copia de seguridad reciente?
• ¿Has localizado el archivo wp-config.php correcto?
• ¿DB_NAME coincide con la base de datos real?
• ¿DB_USER existe?
• ¿DB_PASSWORD es correcta?
• ¿DB_HOST es el que usa tu hosting?
• ¿El usuario tiene permisos sobre la base de datos?
• ¿La base de datos existe y tiene tablas?
• ¿MySQL o MariaDB está funcionando?
• ¿phpMyAdmin conecta?
• ¿El hosting tiene alguna incidencia?
• ¿El error aparece después de una migración o restauración?
• ¿Hay una tienda WooCommerce con pedidos recientes?

Cuándo pedir ayuda para reparar este error

Este error puede ser sencillo si solo hay una contraseña mal puesta. Pero puede complicarse si hay migraciones, bases dañadas, tiendas online, restauraciones o problemas de servidor.

Pide ayuda si:

• no sabes acceder a wp-config.php;
• no sabes cuál es la base de datos correcta;
• la web es una tienda online;
• hay pedidos, usuarios o datos recientes;
• el error apareció después de una migración;
• has restaurado una copia y sigue fallando;
• phpMyAdmin no conecta;
• el hosting no te da una respuesta clara;
• no tienes copia de seguridad.

Mantenimiento WordPress para evitar este tipo de errores

Este error demuestra algo importante: WordPress no es solo diseño y contenidos. También depende de servidor, base de datos, copias, usuarios, actualizaciones y mantenimiento técnico.

Un servicio de mantenimiento WordPress puede ayudar a revisar copias, actualizaciones, errores, recursos del hosting y funcionamiento general de la web.

Si tu web es importante para conseguir contactos, vender o dar servicio, no conviene esperar a que aparezca un mensaje de error para saber si hay copia o acceso al hosting.

Qué deberías tener claro sobre este error

El error al establecer conexión con la base de datos en WordPress suele estar relacionado con datos de conexión incorrectos, una base de datos inaccesible, permisos mal configurados o problemas del servidor MySQL/MariaDB.

La solución pasa por revisar con orden: wp-config.php, base de datos, usuario, contraseña, servidor, permisos y estado del hosting.

Si ocurre después de una migración, restauración o cambio de hosting, casi siempre hay que revisar la relación entre archivos y base de datos. Y si la web es una tienda online, hay que actuar con especial cuidado para no perder datos recientes.

Preguntas frecuentes sobre el error al establecer conexión con la base de datos

¿Qué significa “Error al establecer conexión con la base de datos”?

Significa que WordPress no puede conectarse a la base de datos donde guarda contenidos, ajustes, usuarios y otra información esencial de la web.

¿Cuál es la causa más habitual de este error?

Una de las causas más habituales es que los datos de conexión en wp-config.php sean incorrectos: nombre de base de datos, usuario, contraseña o servidor.

¿Dónde están los datos de la base de datos en WordPress?

Están en el archivo wp-config.php, dentro de las constantes DB_NAME, DB_USER, DB_PASSWORD y DB_HOST.

¿Qué es DB_HOST?

DB_HOST indica el servidor donde está alojada la base de datos. En muchos casos es localhost, pero algunos hostings usan un valor diferente.

¿Puede aparecer este error después de migrar WordPress?

Sí. Es muy habitual después de una migración si no coinciden el nombre de la base de datos, usuario, contraseña o servidor de base de datos.

¿Puede ser culpa del hosting?

Sí. Si MySQL o MariaDB está caído, saturado o limitado por el hosting, WordPress puede mostrar este error aunque los datos sean correctos.

¿Puedo reparar la base de datos desde WordPress?

WordPress permite activar una herramienta de reparación añadiendo WP_ALLOW_REPAIR en wp-config.php, pero conviene hacerlo con cuidado y eliminar esa línea al terminar.

¿Es peligroso restaurar una copia?

Depende. Puede solucionar el problema, pero en tiendas online o webs con datos recientes puede provocar pérdida de pedidos, formularios o cambios recientes si la copia es antigua.

¿Qué hago si no sé cuál es la base de datos correcta?

Revisa el panel del hosting, phpMyAdmin y wp-config.php. Si hay varias bases de datos, conviene comprobar tablas, prefijos y fechas antes de tocar nada.

¿ideaWeb puede reparar este error?

Sí. Podemos revisar archivos, base de datos, credenciales, hosting, permisos, migraciones y restauraciones para recuperar una web WordPress con este error.