Solucionar 'Error estableciendo conexión con la base de datos' WordPress

¡Hola! Si has llegado hasta aquí, probablemente te has encontrado con un mensaje bastante frustrante en tu sitio web: "Error estableciendo conexión con la base de datos". No te preocupes, es uno de los errores más comunes en WordPress y, en la gran mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

Este error significa, literalmente, que WordPress no puede comunicarse con la base de datos donde se almacenan tus contenidos, usuarios y configuraciones. Es como si intentaras abrir una tienda pero la puerta del almacén estuviera cerrada con llave y no tuvieras la llave correcta. Vamos a abrir esa puerta juntos, paso a paso y sin tecnicismos complicados.

Aquí te explicamos cómo diagnosticar y solucionar el error de base de datos en WordPress de forma segura y efectiva.

¿Por qué ocurre este error?

Antes de lanzarnos a arreglar nada, es útil entender qué puede estar causando el problema. Las causas más habituales son:

Datos de acceso incorrectos: El archivo de configuración de WordPress tiene un nombre de usuario, contraseña o nombre de base de datos que no coinciden con los reales.
El servidor de base de datos está caído: Puede que tu proveedor de hosting esté teniendo problemas técnicos o que el servicio de bases de datos se haya detenido.
Archivos corruptos: El archivo wp-config.php (el "cerebro" de la configuración) puede haberse dañado o tener caracteres extraños.
Problemas de memoria: En ocasiones, el servidor se queda sin memoria y no puede procesar las solicitudes.
Ataques o inyecciones de código: Algo malicioso puede haber alterado la configuración (poco común, pero posible).

Ahora sí, vamos a la acción. Sigue estos pasos en orden, ya que van de lo más simple a lo más complejo.

Paso 1: Verifica si el problema es general o solo tuyo

Lo primero es descartar que el problema sea del servidor y no de tu sitio. Una forma rápida es intentar acceder a la URL de tu sitio web desde otro dispositivo, como tu móvil con datos móviles (desactivando el WiFi) o desde una red diferente.

También puedes probar a acceder directamente al panel de administración de tu hosting (cPanel, Plesk, Syspanel, etc.). Si no puedes entrar ni al panel de control, es muy probable que el problema sea del servidor. En ese caso, contacta con tu proveedor de hosting y pregunta si hay alguna incidencia. Si el panel funciona pero tu web no, continúa con el siguiente paso.

Paso 2: Revisa el archivo wp-config.php (La causa más común)

Este es el archivo más importante para este error. Es el que contiene las credenciales de acceso a tu base de datos. Un simple error tipográfico aquí puede provocar el fallo. Vamos a revisarlo.

### ¿Cómo acceder a wp-config.php?

Necesitas un Cliente FTP (como FileZilla) o el Administrador de Archivos de tu panel de hosting.

Conéctate a tu hosting y navega hasta la carpeta donde está instalado WordPress. Normalmente es public_html, www o el nombre de tu dominio.
Busca el archivo llamado wp-config.php.
Descárgalo a tu ordenador para tener una copia de seguridad antes de tocarlo.
Ábrelo con un editor de texto plano (como el Bloc de notas) y busca la sección que dice // ** Ajustes de MySQL ** //.

### ¿Qué debo buscar?

Verás líneas de código similares a estas:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Comprueba estos cuatro puntos:

DB_NAME: Asegúrate de que el nombre de la base de datos es exactamente el mismo que tienes en tu panel de hosting. Un error aquí es muy común.
DB_USER: Verifica que el usuario es el correcto. A veces, el usuario y la base de datos comparten el mismo nombre, pero no siempre.
DB_PASSWORD: La contraseña debe ser exacta, incluyendo mayúsculas, minúsculas y caracteres especiales. Si no la recuerdas, puedes cambiarla desde tu panel de hosting (te explicamos cómo abajo).
DB_HOST: Este suele ser localhost, pero algunos proveedores usan una dirección específica (por ejemplo, mysql.tudominio.com). Debe coincidir exactamente con lo que te indica tu proveedor.

[TIP] Si no estás seguro de estos datos, entra en tu panel de hosting y busca la sección "Bases de datos MySQL". Allí encontrarás el nombre de la base, el usuario y podrás cambiar la contraseña. En Syspanel (accesible por el puerto 2106), esta opción suele estar en "Base de Datos" o "MySQL".

Si has modificado algo, guarda el archivo y súbelo de nuevo a tu hosting (reemplazando el original). Luego, recarga tu web.

Paso 3: Repara tu base de datos (Si los datos son correctos)

Si los datos son correctos pero el error persiste, es posible que la base de datos esté "rota" o dañada. WordPress tiene una función de reparación automática que podemos activar manualmente.

Accede de nuevo a tu archivo wp-config.php.
Busca la línea que dice define('WP_DEBUG', false);.
Justo después de esa línea, añade esta nueva línea:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y súbelo a tu hosting.
Ahora, visita esta URL en tu navegador: https://tudominio.com/wp-admin/maint/repair.php
Pulsa el botón "Reparar base de datos".
Cuando termine, elimina la línea que añadiste (la de WP_ALLOW_REPAIR) y vuelve a subir el archivo. Es muy importante no dejar esto activo por seguridad.

[WARNING] No olvides quitar la línea WP_ALLOW_REPAIR después de usarla. Dejarla activa es un riesgo de seguridad, ya que cualquiera podría acceder a esa URL.

Paso 4: Aumenta la memoria PHP (Si el error es intermitente)

A veces, el error aparece de vez en cuando, no siempre. Esto puede deberse a que el servidor se queda sin memoria PHP. Podemos intentar aumentarla.

Accede a tu archivo wp-config.php de nuevo.
Justo después de la línea define('WP_DEBUG', false);, añade esta línea:

define('WP_MEMORY_LIMIT', '256M');

Guarda el archivo y súbelo. Esto le da a WordPress más memoria para trabajar.

Si esto no funciona, también puedes intentar modificar el archivo .htaccess (si usas Apache). Añade esta línea al principio del archivo:

php_value memory_limit 256M

[INFO] No todos los servidores permiten esta modificación. Si después de esto tu web sigue fallando, es posible que el límite esté impuesto por el hosting y no se pueda cambiar desde tu lado.

Paso 5: Comprueba el estado del servidor MySQL

Como mencionamos al principio, el servidor de bases de datos puede estar caído. Aunque tu panel de hosting funcione, el servicio MySQL puede estar detenido.

Si tienes acceso a cPanel, busca la sección "MySQL" o "Bases de datos" y verás si el servicio está activo.
Si usas Syspanel (recuerda, accede por el puerto 2106), busca la sección de "Servicios" o "Gestión de servicios". Deberías poder ver el estado de MySQL y, con un botón, reiniciarlo.

Reiniciar el servicio MySQL es un proceso seguro y suele solucionar el problema al instante si era un fallo temporal del servidor.

Paso 6: Restaura una copia de seguridad (El último recurso)

Si has llegado hasta aquí y nada funciona, es el momento de considerar restaurar una copia de seguridad anterior de tu sitio. Esto deshará cualquier cambio que haya causado el problema.

Ve a tu panel de hosting y busca la sección de "Copias de seguridad" o "Backups".
Elige una copia que sea anterior a cuando empezaste a ver el error.
Restaura solo la base de datos o el sitio completo (archivos y base de datos) según lo que te ofrezca el sistema.

[WARNING] ¡Ojo! Restaurar una copia de seguridad sobrescribirá cualquier cambio que hayas hecho desde esa fecha. Asegúrate de que es una copia de la que te fías y que no perderás información crítica importante (como pedidos recientes si tienes una tienda).

Preguntas Frecuentes (FAQ)

### ¿Por qué me aparece "Error al conectar con la base de datos" al cambiar de hosting?

Es muy común. Al cambiar de hosting, las credenciales de la base de datos suelen cambiar. Lo más probable es que el archivo wp-config.php tenga los datos antiguos. Revisa el Paso 2 y actualiza DB_NAME, DB_USER y DB_PASSWORD con los nuevos datos que te haya dado tu nuevo proveedor.

### El error dice "Una o más tablas de la base de datos no están disponibles".

Este mensaje específico indica que una tabla concreta está dañada. El Paso 3 (la reparación con WP_ALLOW_REPAIR) es tu mejor aliado aquí. Si no funciona, contacta con tu soporte de hosting, ya que puede ser necesario reparar la tabla a nivel de servidor.

### ¿Puedo solucionar el error de conexión de WordPress sin acceso al panel de administración?

Sí, absolutamente. Todos los pasos de esta guía se hacen a través de FTP, el administrador de archivos de tu hosting o el panel de control. No necesitas acceder a tu panel de WordPress (wp-admin) para nada, ya que ese es el que está dando el error.

### ¿Qué hago si he cambiado la contraseña de la base de datos y ahora no funciona?

Si has cambiado la contraseña desde tu panel de hosting, debes actualizarla también en el archivo wp-config.php. Ve al Paso 2 y cambia el valor de DB_PASSWORD por la nueva contraseña. Es un error muy común, ¡tranquilo!

### ¿Este error puede deberse a un plugin o tema?

Es muy poco probable. Los plugins y temas afectan a la capa de presentación y funcionalidad, pero no a la conexión directa con la base de datos. Si el error es de conexión, el problema está en la configuración del servidor o en el archivo wp-config.php.

Conclusión: Mantén la calma y sigue los pasos

En resumen, el error de conexión con WordPress es un problema serio pero casi siempre solucionable. La clave está en ser metódico y no saltarse pasos.

Revisa los datos en wp-config.php.
Usa la reparación automática de WordPress.
Aumenta la memoria si es un fallo intermitente.
Comprueba el servicio MySQL en tu hosting.
Restaura una copia de seguridad como último recurso.

Recuerda que siempre puedes contactar con el soporte técnico de tu proveedor de hosting; para eso están. Dales toda la información que puedas sobre el error y los pasos que ya has probado.

Esperamos que esta guía te haya sido de gran ayuda y que tu sitio web esté de nuevo en línea en un abrir y cerrar de ojos. ¡Mucha suerte!