Solucionar Error de Conexión a Base de Datos en WordPress (MySQL)

¡Hola! Si estás leyendo esto, es muy probable que te hayas encontrado con el mensaje más temido por cualquier administrador de WordPress: "Error establishing a database connection".

No te preocupes, respira hondo. Este error es mucho más común de lo que parece 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 informática.

En esta guía extensa y detallada, vamos a desglosar paso a paso qué significa este error, por qué ocurre y, lo más importante, cómo solucionarlo para que tu web vuelva a estar en línea en cuestión de minutos.

Vamos a ello.

¿Qué significa exactamente "Error establishing a database connection"?

Para entenderlo fácilmente, imagina que tu sitio web es una tienda física.

WordPress (el encargado de mostrar la tienda) necesita acceder a un almacén gigante donde tiene guardados todos sus productos: los textos de tus páginas, los comentarios de tus usuarios, tus ajustes de configuración, etc. Ese almacén es la base de datos (normalmente MySQL o MariaDB).

El mensaje de error "Error establishing a database connection" (o su equivalente en español "Error de conexión con la base de datos") significa que WordPress está intentando abrir la puerta del almacén, pero no puede. O bien la llave no es la correcta, o el almacén está cerrado, o la puerta está rota.

Cuando esto ocurre, WordPress no puede cargar nada de tu web, por lo que muestra este mensaje genérico. Es un mecanismo de seguridad para no mostrar información sensible, pero a nosotros nos toca ponernos el mono de trabajo.

Primeros pasos: Diagnóstico rápido (y no te asustes)

Antes de empezar a tocar archivos, vamos a hacer una pequeña comprobación que puede ahorrarte muchos quebraderos de cabeza.

¿Es un problema general o solo tuyo?

A veces, el problema no es de tu web, sino de tu conexión a Internet o de tu proveedor de servicios. Para comprobarlo, visita una web como DownDetector o simplemente pide a un amigo o familiar que intente entrar a tu página desde su móvil (con datos, no con tu WiFi).

Si tu amigo puede verla y tú no, el problema es de tu red local o de tu caché. Prueba a reiniciar el router o a limpiar la caché de tu navegador.

Si nadie puede verla, entonces el problema es real y vamos a solucionarlo. Sigue leyendo.

Causa #1: Credenciales de acceso incorrectas (El error más común)

Esta es la causa más frecuente de este error. WordPress guarda los datos de acceso a tu base de datos en un archivo llamado wp-config.php.

Si esos datos son incorrectos (por ejemplo, si cambiaste la contraseña de la base de datos en tu panel de hosting y no actualizaste el archivo), WordPress no podrá conectarse.

Cómo solucionar el error de conexión de WordPress revisando wp-config.php

Para revisarlo, necesitas un Cliente FTP (como FileZilla) o el Administrador de Archivos de tu panel de control de hosting.

Accede a la carpeta raíz de tu instalación de WordPress (normalmente llamada public_html o www). Busca el archivo wp-config.php. Ábrelo con un editor de texto (como el Bloc de notas o Sublime Text).

Dentro, verás unas líneas similares a estas:

// ** Ajustes de MySQL ** //
define( 'DB_NAME', 'nombre_de_tu_base' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

Aquí es donde debes fijarte:

DB_NAME: Es el nombre exacto de tu base de datos.
DB_USER: Es el usuario que tiene acceso a esa base de datos.
DB_PASSWORD: Es la contraseña de ese usuario.
DB_HOST: Es el servidor donde está alojada la base de datos. Normalmente es localhost, pero a veces puede ser algo como sql.midominio.com o mysql.tudominio.com.

Verifica estos datos con los que tienes en tu panel de hosting. Si no los recuerdas, no los adivines. Ve a tu panel de control de hosting, busca la sección de "Bases de datos MySQL" y compáralos.

[WARNING] Si cambiaste la contraseña de la base de datos recientemente, asegúrate de haber actualizado también este archivo. Es el error más típico después de un cambio de contraseña.

Causa #2: El servidor de la base de datos está caído o sobrecargado

A veces, el problema no está en tu configuración, sino en el propio servidor que aloja tu base de datos. Esto puede pasar si tu hosting tiene un problema temporal, está realizando mantenimiento o ha sido saturado por un pico de tráfico.

Cómo arreglar la conexión WP comprobando el estado del servidor

Revisa el correo electrónico: Los proveedores de hosting suelen enviar correos avisando de mantenimientos programados o incidencias. Revisa tu bandeja de entrada.
Contacta con tu proveedor: Si no hay ningún aviso, contacta con el soporte técnico de tu hosting. Pregunta directamente: "¿El servidor de bases de datos MySQL está operativo?". Ellos podrán verificar el estado al instante.

[TIP] Si tienes acceso a Syspanel (el panel de control que antes se llamaba HestiaCP y que se accede a través del puerto 2106), a menudo puedes ver el estado de los servicios. Busca una sección de "Servicios" o "Estado del sistema" para ver si MySQL/MariaDB aparece en verde o en rojo. Si está en rojo, intenta reiniciarlo desde ahí mismo, siempre que tengas permisos para ello.

Causa #3: El servidor de la base de datos está saturado (Demasiadas conexiones)

Este es un problema muy común en hosting compartido. Imagina que el almacén solo permite entrar a 10 personas a la vez. Si hay 20 tiendas (webs) intentando entrar al mismo tiempo, las otras 10 se quedan fuera y reciben el error de conexión.

Esto suele pasar si tu web tiene un pico de tráfico muy alto o si tienes muchos plugins que hacen muchas consultas a la base de datos.

Soluciones para el error de base de datos de WordPress por saturación

Espera unos minutos: Si es un pico puntual, el sistema se estabilizará solo. Intenta recargar la página después de 5-10 minutos.
Optimiza tu base de datos: Existen plugins como WP-Optimize o Advanced Database Cleaner que te permiten limpiar tablas obsoletas (como revisiones de entradas, transients caducados o comentarios spam) y reducir la carga.
Instala un plugin de caché: Plugins como W3 Total Cache o WP Super Cache generan versiones estáticas de tus páginas, lo que reduce drásticamente el número de consultas a la base de datos. Esto es vital para la salud de tu web.

[INFO] Si este problema es recurrente, puede que tu plan de hosting sea insuficiente para el tráfico que recibes. Plantéate migrar a un hosting con más recursos, como un VPS o un servidor dedicado.

Causa #4: El archivo wp-config.php está dañado o incompleto

A veces, al editar el archivo wp-config.php (por ejemplo, para añadir código de seguridad), podemos romper algo sin darnos cuenta. Un carácter mal colocado o un espacio de más pueden provocar que el archivo no se lea correctamente.

Cómo solucionar el error de conexión MySQL en WordPress reparando el archivo

La solución más segura es reemplazar el archivo por uno nuevo y limpio.

Descarga una copia nueva de WordPress: Ve a es.wordpress.org y descarga el archivo ZIP de la última versión.
Extrae el ZIP: Descomprime el archivo en tu ordenador.
Busca el archivo wp-config-sample.php: Está en la carpeta raíz de la descarga. Ábrelo con un editor de texto.
Copia el contenido: Selecciona todo el texto y cópialo.
Pega en tu archivo actual: Ahora, en tu servidor, abre tu wp-config.php actual, borra TODO el contenido y pega el que has copiado del archivo de muestra.
Reintroduce tus datos: Ahora, vuelve a introducir los datos de tu base de datos (nombre, usuario, contraseña y host) en las líneas correspondientes.
Guarda y sube el archivo: Guarda los cambios y sube el archivo a tu servidor, reemplazando el existente.

[WARNING] No borres el archivo wp-config.php sin tener una copia de seguridad de tus credenciales. Si lo haces, perderás el acceso a tu web.

Causa #5: El prefijo de las tablas es incorrecto

El prefijo de las tablas de WordPress es, por defecto, wp_. Sin embargo, por seguridad, algunas personas lo cambian a algo como miweb_ o blog_. Si este prefijo no coincide entre tu archivo wp-config.php y las tablas reales en tu base de datos, WordPress no encontrará las tablas y fallará la conexión.

Cómo arreglar el error de conexión de WordPress verificando el prefijo

Revisa tu wp-config.php: Busca la línea que dice $table_prefix = 'wp_';. Anota el valor que tenga.
Revisa tu base de datos: Accede a phpMyAdmin (desde tu panel de hosting o desde Syspanel, en el puerto 2106). Busca tu base de datos y mira los nombres de las tablas. Deben empezar con el mismo prefijo (ej. wp_options, wp_posts, etc.).
Hazlos coincidir: Si no coinciden, edita el wp-config.php para que el prefijo sea el correcto. No intentes cambiar los nombres de las tablas en la base de datos, es mucho más seguro cambiar el valor en el archivo de configuración.

Causa #6: Problemas con el host de la base de datos (DB_HOST)

Aunque lo más común es que sea localhost, muchos servicios de hosting utilizan un host específico para las bases de datos, como localhost:3306 o una URL como db.midominio.com.

Cómo solucionar el error de conexión MySQL revisando el DB_HOST

Consulta la documentación de tu hosting: Busca en Google "nombre de tu hosting + host de base de datos MySQL". Te dirán exactamente qué valor debes usar.
Pruébalo: Si tu hosting te da una dirección específica, cámbiala en tu wp-config.php. A veces, cambiar de localhost a 127.0.0.1 también funciona, ya que es la dirección IP de bucle local.

[TIP] Si tienes dudas, contacta con el soporte de tu hosting. Es una pregunta muy común y te la responderán en segundos.

Causa #7: Archivos corruptos de WordPress

Si has intentado todo lo anterior y nada funciona, es posible que los archivos principales de WordPress estén dañados. Esto puede pasar por una actualización fallida o un ataque malintencionado.

Cómo arreglar la conexión WP reemplazando archivos principales

Esta es una solución de "fuerza bruta" pero muy efectiva. Vamos a reemplazar los archivos principales de WordPress sin tocar tu contenido.

Descarga una copia nueva de WordPress desde es.wordpress.org.
Descomprime el ZIP en tu ordenador.
Accede a tu servidor por FTP y ve a la carpeta raíz de tu instalación.
Sube todos los archivos y carpetas de la descarga, excepto la carpeta wp-content (que contiene tus temas, plugins y subidas) y el archivo wp-config.php (que ya tienes configurado).
Sobrescribe los archivos existentes: Cuando tu cliente FTP te pregunte si quieres sobrescribir, dile que sí a todos.

Este proceso reemplazará los archivos del núcleo de WordPress que puedan estar dañados por otros nuevos y limpios, sin tocar tus fotos, tus entradas ni tus plugins.

Preguntas Frecuentes (FAQ)

Para finalizar, aquí tienes las respuestas a las preguntas más habituales sobre este error.

¿Por qué mi WordPress dice "error de conexión con la base de datos" sin haber tocado nada?

Esto puede deberse a un problema temporal del servidor de tu hosting, a un pico de tráfico que saturó la base de datos, o a que el servidor se ha quedado sin memoria. En la mayoría de los casos, se soluciona solo o con un reinicio del servicio desde el panel de control (como Syspanel, accesible por el puerto 2106).

¿Cómo puedo saber si el problema es de mi hosting o de mi web?

La mejor forma es contactar con el soporte técnico de tu hosting. Ellos pueden verificar el estado del servidor de bases de datos y decirte si hay una incidencia general. Si el servidor está bien, el problema es de tu configuración o de tus archivos.

¿Puedo perder mis datos si intento arreglar este error?

No, siempre y cuando sigas los pasos de esta guía y no borres la base de datos ni la carpeta wp-content. Los pasos que te hemos dado (revisar credenciales, reparar archivos) no afectan a tus datos.

¿Qué hago si ninguna de estas soluciones funciona?

Si has probado todos los pasos anteriores y el error persiste, te recomiendo encarecidamente que contactes con el soporte técnico de tu proveedor de hosting. Ellos tienen acceso directo a los servidores y podrán diagnosticar el problema a un nivel más profundo. Es posible que haya un problema de permisos en el servidor o un fallo de configuración que solo ellos pueden ver.

Esperamos que esta guía completa te haya sido de gran ayuda. Como has visto, el error "Error establishing a database connection" en WordPress, aunque parezca grave, tiene solución en la gran mayoría de los casos. Recuerda siempre ir paso a paso, con calma y no tocar nada que no entiendas.

Si tienes alguna otra duda, déjanos un comentario y estaremos encantados de ayudarte. ¡Buena suerte con tu web!