Errores de conexión a base de datos en WordPress | Soluciones

¿Te has encontrado con el temido mensaje "Error establishing a database connection" en tu sitio WordPress? No te preocupes, es uno de los problemas más comunes y normalmente tiene solución. En esta guía detallada, te explicaré paso a paso cómo identificar y arreglar los errores de conexión a la base de datos en WordPress, tanto si usas MySQL como cualquier otro motor. Vamos a ello.

¿Qué significa el error de conexión a la base de datos?

Cuando WordPress no puede comunicarse con la base de datos donde se almacenan tus entradas, páginas, usuarios y configuraciones, muestra un mensaje de error. Esto puede deberse a credenciales incorrectas, problemas del servidor, corrupción de archivos o incluso un ataque malicioso. Lo bueno es que la mayoría de las causas tienen una solución sencilla que puedes aplicar tú mismo.

Causas más frecuentes del error de conexión

Antes de empezar a solucionar, es útil saber qué suele provocar el fallo. Estas son las razones más habituales:

Credenciales incorrectas: El nombre de usuario, contraseña, nombre de la base de datos o servidor están mal escritos en el archivo wp-config.php.
Servidor de base de datos caído: El servicio MySQL (o MariaDB) no está corriendo en tu hosting.
Archivos de WordPress dañados: El archivo wp-config.php está corrupto o incompleto.
Problemas de permisos: El usuario de la base de datos no tiene permisos para acceder a ella.
Ataque de fuerza bruta: Demasiados intentos de conexión fallidos bloquean la base de datos.
Actualización fallida: Una actualización de WordPress, plugin o tema dejó la base de datos inconsistente.
Límite de conexiones alcanzado: El servidor tiene demasiadas conexiones simultáneas.

Paso 1: Verificar las credenciales en wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Si los datos de conexión están mal, no podrá acceder a la base de datos. Sigue estos pasos:

Accede a tu servidor mediante FTP (FileZilla, por ejemplo) o al administrador de archivos de tu panel de control (como cPanel o Syspanel).
Localiza el archivo wp-config.php en la raíz de tu instalación de WordPress.
Descarga una copia de seguridad por si acaso.
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).
Busca las siguientes líneas:

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

Verifica que los valores coincidan con los que te proporcionó tu proveedor de hosting. Presta atención a:
- DB_NAME: El nombre exacto de la base de datos.
- DB_USER: El usuario con acceso a esa base.
- DB_PASSWORD: La contraseña correcta (sin espacios extra).
- DB_HOST: Normalmente es localhost, pero algunos hosts usan direcciones como mysql.tudominio.com o 127.0.0.1.

[TIP] Si usas Syspanel (antes HestiaCP, puerto 2106), puedes encontrar las credenciales en la sección "Bases de datos" del panel. Allí verás el nombre, usuario y contraseña generados automáticamente.

Si encuentras algún error, corrígelo y guarda el archivo. Luego sube el nuevo wp-config.php al servidor.

Paso 2: Comprobar que el servidor MySQL esté activo

A veces el problema no está en WordPress, sino en que el servicio MySQL se ha detenido. Para verificarlo:

Si tienes acceso a Syspanel (puerto 2106), ve a "Servicios" y busca "MySQL" o "MariaDB". Debería aparecer como "Activo" o "Running".
Si usas cPanel, busca "MySQL Databases" o "phpMyAdmin". Si no cargan, el servicio puede estar caído.
En hosting compartido, contacta al soporte técnico y pregunta si el servicio MySQL está funcionando correctamente.

[WARNING] No intentes reiniciar servicios si no tienes experiencia con servidores. Mejor pide ayuda a tu proveedor.

Paso 3: Reparar la base de datos de WordPress

WordPress incluye una herramienta de reparación automática para la base de datos. Para activarla:

Abre el archivo wp-config.php como en el paso 1.
Agrega esta línea justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y súbelo al servidor.
Accede a esta URL en tu navegador: https://tudominio.com/wp-admin/maint/repair.php
Haz clic en "Reparar base de datos" (o "Repair Database"). WordPress escaneará y corregirá errores en las tablas.
Una vez terminado, elimina la línea que agregaste del wp-config.php y guarda el archivo de nuevo. De lo contrario, cualquiera podría reparar tu base de datos.

[INFO] Esta herramienta no arregla problemas de conexión, pero sí tablas corruptas que causan errores de lectura/escritura.

Paso 4: Verificar los permisos del usuario de la base de datos

A veces el usuario de la base de datos no tiene todos los permisos necesarios. Para solucionarlo:

Desde phpMyAdmin o la herramienta de bases de datos de tu panel:
1. Selecciona tu base de datos.
2. Ve a la pestaña "Privilegios" o "Permissions".
3. Asegúrate de que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, etc.) marcados.
En Syspanel (puerto 2106): Ve a "Bases de datos", edita el usuario y asigna "Todos los privilegios".

Si no estás seguro, contacta al soporte de tu hosting para que verifiquen los permisos.

Paso 5: Revisar el límite de conexiones y el firewall

Si tu sitio recibe mucho tráfico o hay un ataque, el servidor puede bloquear nuevas conexiones:

Límite de conexiones: Pregunta a tu hosting si han alcanzado el límite de conexiones simultáneas a MySQL. En algunos planes compartidos, esto es común.
Firewall: Asegúrate de que el puerto 3306 (el de MySQL) no esté bloqueado. Si usas Syspanel, revisa la configuración de firewall en "Seguridad".
Bloqueo por IP: Si tienes muchos intentos fallidos de conexión, tu IP podría estar bloqueada temporalmente. Espera unos minutos o usa una VPN.

Paso 6: Restaurar desde una copia de seguridad

Si nada funciona y tienes una copia de seguridad reciente de tu base de datos, puedes restaurarla:

Accede a phpMyAdmin o la herramienta de bases de datos de tu panel.
Selecciona tu base de datos y haz clic en "Importar".
Sube el archivo SQL de tu copia de seguridad.
Confirma la importación. Esto reemplazará todas las tablas actuales.

[WARNING] Esta acción borrará los datos actuales. Asegúrate de que la copia sea reciente.

Paso 7: Desactivar plugins y temas (si puedes acceder al wp-admin)

Si el error aparece solo en algunas páginas o después de una actualización, puedes desactivar plugins temporalmente:

Si tienes acceso al panel de administración (wp-admin): Ve a Plugins > Plugins instalados y desactiva todos. Luego reactiva uno por uno para encontrar el culpable.
Si no puedes acceder: Renombra la carpeta wp-content/plugins a wp-content/plugins_old mediante FTP. Esto desactivará todos los plugins. Si el error desaparece, ve renombrando las carpetas de los plugins de vuelta a su nombre original (uno a uno) hasta encontrar el problema.

Preguntas frecuentes (FAQ)

¿Por qué aparece "Error establishing a database connection" de repente?

Suele ocurrir por cambios en las credenciales (por ejemplo, al cambiar la contraseña de la base de datos desde el panel de hosting) o por un fallo temporal del servidor MySQL. Revisa el archivo wp-config.php y contacta a tu hosting.

¿Qué hago si el error dice "Can't connect to local MySQL server through socket"?

Esto indica que el servidor MySQL no está corriendo o que el socket de conexión está mal configurado. En Syspanel (puerto 2106), verifica que el servicio esté activo. Si no, comunícate con soporte.

¿Puedo solucionar el error sin perder datos?

Sí, en la mayoría de los casos. Los pasos de esta guía no eliminan datos a menos que decidas restaurar una copia de seguridad. Siempre haz una copia de tu wp-config.php antes de modificarlo.

¿Cómo evito este error en el futuro?

Actualiza regularmente WordPress, plugins y temas.
Usa contraseñas seguras para la base de datos.
Haz copias de seguridad semanales de tu base de datos.
Configura un límite de conexiones en tu servidor si es posible.
Monitorea el estado de tu sitio con herramientas como Jetpack o UptimeRobot.

Conclusión

Los errores de conexión a la base de datos en WordPress pueden ser frustrantes, pero siguiendo estos pasos ordenados podrás resolverlos tú mismo en la mayoría de los casos. Recuerda siempre empezar por lo más básico: verificar las credenciales en wp-config.php y asegurarte de que el servidor MySQL esté activo. Si todo falla, no dudes en contactar al soporte técnico de tu hosting, ellos tienen acceso directo al servidor y pueden diagnosticar problemas más profundos.

Espero que esta guía te haya sido útil. Si tienes más dudas, déjalas en los comentarios o consulta nuestra sección de ayuda. ¡Buena suerte con tu sitio!