Cómo solucionar error de conexión a base de datos en WordPress

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a desentrañar uno de los errores más frustrantes que puedes encontrarte en WordPress: el temido error estableciendo conexión con la base de datos. No te preocupes, es un problema común y, en la mayoría de los casos, tiene solución. Vamos a verlo paso a paso, como si estuviéramos sentados frente a tu ordenador.

Este error, que en inglés se conoce como WordPress database connection error, aparece de repente y puede dejar tu web completamente inaccesible. Pero respira hondo: no has perdido tus datos ni tu sitio. Solo necesitas un poco de paciencia y seguir esta guía.

¿Qué significa exactamente este error?

Imagina que tu web WordPress es una biblioteca. Los archivos de WordPress (el edificio) están en un lado, y los libros (tu contenido, usuarios, configuraciones) están en la base de datos, que es como el almacén. Cuando alguien visita tu web, WordPress intenta ir al almacén a buscar los libros. El error estableciendo conexión con la base datos WordPress significa que la puerta del almacén está cerrada, la llave no funciona, o el almacén se ha mudado de sitio.

Las causas más comunes son:

Datos de conexión incorrectos (usuario, contraseña, nombre de la base de datos).
El servidor de la base de datos (MySQL/MariaDB) está caído o sobrecargado.
Archivos de WordPress dañados, especialmente wp-config.php.
Problemas con el plugin o tema que estás usando.
Ataques maliciosos o corrupción de la base de datos.

Vamos a solucionar error base datos WordPress con métodos ordenados, del más simple al más complejo. No necesitas ser un experto en programación.

Primeros pasos: verifica si es un problema general

Antes de tocar nada, haz esta prueba rápida. Intenta acceder a tu web desde otro dispositivo o red (por ejemplo, desde el móvil con datos). Si el error solo aparece en tu ordenador, puede ser un problema de caché local o DNS. Borra la caché de tu navegador y prueba de nuevo.

Si el error persiste en todos los dispositivos, entonces es un problema en el servidor. Vamos a ello.

Método 1: Revisar y corregir el archivo wp-config.php

Este es el archivo más importante para la conexión a la base de datos. Contiene las credenciales. Si algo está mal aquí, tendremos el error.

Paso 1: Accede a tus archivos

Necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu panel de hosting.

[INFO] Si usas Syspanel (el panel de control de HestiaCP), puedes acceder por FTP o por el Administrador de Archivos. Para entrar a Syspanel, abre tu navegador y escribe https://tudominio.com:2106 (el puerto 2106 es clave). Inicia sesión con tus credenciales de hosting.

Paso 2: Localiza y edita wp-config.php

En la raíz de tu instalación de WordPress (la carpeta donde están las carpetas wp-admin, wp-content, etc.), busca el archivo wp-config.php. Descárgalo a tu ordenador o ábrelo con un editor de texto (nunca con Word, usa Notepad++ o similar).

Paso 3: Verifica las credenciales

Busca estas líneas:

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

Comprueba que los datos sean correctos. El nombre de la base de datos, el usuario y la contraseña los puedes encontrar en tu panel de hosting (Syspanel, cPanel, etc.). El DB_HOST suele ser localhost, pero algunos hosts usan algo como mysql.tudominio.com. Si no estás seguro, consulta con tu proveedor.

[WARNING] No cambies nada más en este archivo. Un solo espacio de más puede romper tu web.

Si los datos son correctos, pasa al siguiente método. Si no, corrígelos, guarda el archivo y súbelo de nuevo (o pégalo en el editor de archivos de Syspanel). Luego recarga tu web.

Método 2: Reparar la base de datos desde wp-config.php

WordPress tiene una herramienta de reparación oculta. Actívala añadiendo una línea a tu wp-config.php.

Paso 1: Añade la línea de reparación

Justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */, añade esto:

define('WP_ALLOW_REPAIR', true);

Paso 2: Accede a la herramienta

Guarda el archivo y luego visita en tu navegador: https://tudominio.com/wp-admin/maint/repair.php

Verás dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Elige la segunda. Esto revisará y arreglará tablas dañadas.

Paso 3: Desactiva la herramienta

Una vez terminado, es crucial que borres la línea que añadiste. Si la dejas, cualquiera podría acceder a esa URL y dañar tu base de datos. Vuelve a wp-config.php, elimina la línea y guarda.

Método 3: Reiniciar el servidor de base de datos (si tienes acceso)

A veces el servicio MySQL/MariaDB se cuelga. Si tienes acceso a la línea de comandos de tu servidor (por SSH) o a un panel como Syspanel, puedes reiniciarlo.

[TIP] En Syspanel, puedes acceder a "Servicios" desde el menú lateral. Busca "MySQL" o "MariaDB" y haz clic en "Reiniciar". Esto suele resolver problemas temporales.

Si no tienes acceso, contacta con tu soporte técnico y diles: "Por favor, reinicia el servicio MySQL/MariaDB de mi base de datos".

Método 4: Comprobar si el problema es un plugin o tema

A veces un plugin o tema mal codificado rompe la conexión. Como no puedes acceder al panel de administración, tendrás que desactivarlos manualmente.

Paso 1: Desactiva todos los plugins

Conéctate por FTP o al administrador de archivos de Syspanel. Ve a la carpeta wp-content y cambia el nombre de la carpeta plugins a plugins_old. Esto fuerza a WordPress a desactivar todos los plugins.

Si tu web vuelve a funcionar, el problema estaba en un plugin. Para identificarlo, renombra la carpeta a plugins de nuevo, luego ve a /wp-admin/plugins.php y activa los plugins uno por uno hasta que el error vuelva a aparecer. Ese es el culpable.

Paso 2: Prueba con un tema por defecto

Si el error persiste, renombra la carpeta de tu tema activo (dentro de wp-content/themes) a tema_activo_old. WordPress usará automáticamente un tema por defecto (Twenty Twenty-Four, por ejemplo). Si funciona, tu tema es el problema.

Método 5: Verificar la integridad de los archivos de WordPress

Archivos de núcleo dañados pueden causar este error. Puedes reemplazarlos manualmente.

Paso 1: Descarga una copia limpia de WordPress

Ve a wordpress.org/download y descarga la última versión en español.

Paso 2: Sobrescribe los archivos (excepto wp-content y wp-config.php)

Descomprime el ZIP. Conéctate por FTP y sube TODAS las carpetas y archivos (excepto wp-content y wp-config.php) a tu servidor, sobrescribiendo los existentes. Esto reemplazará los archivos del núcleo sin tocar tus datos ni configuraciones.

Método 6: Comprobar los logs de errores

Los logs pueden darte pistas precisas. Si tu hosting tiene acceso a los logs de errores de PHP o MySQL, revísalos.

[INFO] En Syspanel, ve a "Registros" o "Logs" en el menú. Busca el log de errores de tu dominio. Allí verás mensajes como "Access denied for user" (usuario incorrecto) o "Can't connect to MySQL server" (servidor caído).

Si ves algo como ERROR 2002 (HY000): Can't connect to local MySQL server through socket, es un problema del servidor. Contacta con tu soporte.

Método 7: Restaurar desde una copia de seguridad

Si nada funciona, la solución más drástica (pero segura) es restaurar una copia de seguridad reciente de tu base de datos y archivos.

Paso 1: Localiza tu copia de seguridad

La mayoría de los hosts hacen copias automáticas. En Syspanel, ve a "Copias de seguridad" y descarga la más reciente. También puedes tener una en tu ordenador si usas un plugin como UpdraftPlus.

Paso 2: Restaura la base de datos

Usa phpMyAdmin (accesible desde Syspanel, en "Bases de datos" -> "phpMyAdmin"). Selecciona tu base de datos, ve a la pestaña "Importar" y sube el archivo SQL de tu copia de seguridad.

Paso 3: Restaura los archivos

Sube los archivos de tu copia de seguridad por FTP, sobrescribiendo todo. Esto revertirá tu web al estado de la copia.

Preguntas Frecuentes (FAQ)

¿Por qué aparece este error después de cambiar la contraseña de la base de datos?
Porque olvidaste actualizar el archivo wp-config.php con la nueva contraseña. Sigue el Método 1 para corregirlo.

¿Puedo perder mis datos si reparo la base de datos?
No, la herramienta de reparación solo corrige tablas dañadas, no borra contenido. Pero siempre es recomendable tener una copia de seguridad antes.

¿El error puede deberse a un ataque?
Sí, a veces los hackers inyectan código malicioso que rompe la conexión. Si sospechas esto, cambia todas las contraseñas (FTP, base de datos, WordPress) y escanea tu web con un plugin de seguridad (una vez que puedas acceder).

¿Qué hago si no tengo acceso a Syspanel ni a FTP?
Contacta con tu proveedor de hosting. Explícales el error y diles que necesitas ayuda para solucionar error base datos WordPress. Ellos pueden reiniciar servicios o darte acceso temporal.

Resumen: Orden de acciones recomendado

Verifica que el error no sea local (caché del navegador).
Revisa wp-config.php (Método 1).
Repara la base de datos (Método 2).
Reinicia el servicio MySQL (Método 3, si puedes).
Desactiva plugins y tema (Método 4).
Reemplaza archivos del núcleo (Método 5).
Revisa logs (Método 6).
Restaura copia de seguridad (Método 7).

[WARNING] No hagas varios cambios a la vez. Prueba tu web después de cada paso para identificar la causa exacta.

Espero que esta guía te haya sido de ayuda. Recuerda que el error conexión base datos WordPress es como un resfriado: molesto pero tratable. Si sigues estos pasos, lo más probable es que tu web vuelva a la vida en poco tiempo. Si te quedas atascado, no dudes en pedir ayuda a tu equipo de soporte. ¡Buena suerte!