Error de conexión base de datos WordPress: Causas y soluciones

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

Este es uno de los errores más comunes y temidos entre quienes administran sitios web con WordPress. Verás una pantalla en blanco con el mensaje: "Error al establecer una conexión a la base de datos" o "Error de conexión a la base de datos". No te preocupes: en la mayoría de los casos tiene solución y no has perdido tu sitio.

El error ocurre cuando WordPress no puede comunicarse con la base de datos donde guarda todo tu contenido (artículos, páginas, usuarios, configuraciones). Sin esa conexión, tu web no puede cargar nada.

¿Por qué ocurre este fallo? Causas principales

Antes de solucionar, es útil entender qué lo provoca. Las causas más frecuentes son:

Credenciales incorrectas en el archivo wp-config.php (nombre de base de datos, usuario o contraseña).
Problemas del servidor de base de datos (MySQL/MariaDB caído o sobrecargado).
Corrupción de la base de datos por un plugin o actualización fallida.
Límite de conexiones superado (demasiados procesos simultáneos).
Cambios recientes en tu hosting (migración, cambios de contraseña, actualizaciones del panel).

Guía paso a paso para solucionar el error de conexión a la base de datos en WordPress

Sigue estos pasos en orden. No saltes ninguno hasta resolver el problema.

1. Verifica las credenciales en wp-config.php

El archivo wp-config.php está en la raíz de tu instalación de WordPress. Accede a través de FTP, cPanel o el administrador de archivos de tu hosting.

Localiza estas líneas:

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

¿Qué debes comprobar?

Que el nombre de la base de datos sea exactamente el que tienes.
Que el usuario y contraseña coincidan con los que configuraste.
Que el host sea correcto: normalmente localhost, pero algunos proveedores usan direcciones como mysql.tudominio.com.

[TIP] Si no recuerdas tus credenciales, puedes encontrarlas en el panel de control de tu hosting, en la sección de bases de datos MySQL.

2. Comprueba que el servidor de base de datos esté funcionando

Si las credenciales son correctas, el problema puede ser que el servicio MySQL/MariaDB esté caído.

En un servidor compartido: Contacta con el soporte de tu hosting. Ellos pueden reiniciar el servicio.

Si tienes acceso SSH o un panel como Syspanel (puerto 2106):

Accede a tu servidor y ejecuta:

systemctl status mysql

O si usas MariaDB:

systemctl status mariadb

Si el servicio está inactivo, reinícialo:

systemctl restart mysql

[WARNING] No hagas esto si no sabes lo que estás haciendo. Pide ayuda a tu proveedor de hosting.

3. Repara la base de datos desde phpMyAdmin

A veces la base de datos se corrompe parcialmente. WordPress incluye un método de reparación automática.

Accede a phpMyAdmin desde el panel de tu hosting.
Selecciona la base de datos de tu WordPress.
Marca todas las tablas (clic en "Seleccionar todo").
En el menú desplegable, elige "Reparar tabla".

Esto intentará corregir errores menores. Si no funciona, prueba con "Optimizar tabla".

[INFO] Si no ves la opción de reparar, es que tu hosting no la permite. En ese caso, contacta con soporte.

4. Aumenta el límite de conexiones a la base de datos

Si tu sitio recibe mucho tráfico, puede superar el límite de conexiones simultáneas. Esto es común en hosting compartidos.

Solución temporal: Agrega esta línea al archivo wp-config.php (antes de la línea que dice "Eso es todo"):

define('WP_MAX_CONNECTIONS', 10);

Solución definitiva: Habla con tu proveedor de hosting para aumentar el límite o migrar a un plan más potente.

5. Restablece la contraseña de la base de datos

Si sospechas que la contraseña fue cambiada o es incorrecta, restablécelo desde el panel de control de tu hosting.

En Syspanel (puerto 2106):

Ve a Bases de datos.
Selecciona tu base de datos.
Haz clic en Cambiar contraseña.
Copia la nueva contraseña y actualízala en wp-config.php.

[WARNING] Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).

6. Verifica el archivo .htaccess (solo si usas caché o redirecciones)

Un .htaccess corrupto puede interferir con la conexión. Renómbralo temporalmente:

mv .htaccess .htaccess_backup

Luego, ve a Ajustes > Enlaces permanentes en tu panel de WordPress y haz clic en Guardar cambios para regenerarlo.

7. Revisa los logs de errores del servidor

Los logs te darán pistas precisas. Si tienes acceso a SSH:

tail -f /var/log/mysql/error.log

Busca mensajes como "Access denied", "Too many connections" o "Table is marked as crashed".

Preguntas frecuentes (FAQ) sobre el error de conexión a la base de datos

¿Puedo perder mi contenido por este error?

No. El error solo impide que WordPress se cargue. Tus datos siguen en la base de datos. Una vez solucionada la conexión, todo vuelve a la normalidad.

¿Necesito ser programador para solucionarlo?

No. Siguiendo esta guía paso a paso, cualquier persona con acceso al panel de hosting puede resolverlo. Si te sientes inseguro, pide ayuda a soporte técnico.

¿Por qué aparece después de una actualización de WordPress?

Las actualizaciones pueden cambiar la estructura de la base de datos. Si algo falla durante el proceso, la conexión se rompe. Repara las tablas (paso 3) y todo debería andar.

¿Qué hago si ninguna solución funciona?

Si has seguido todos los pasos y el error persiste, contacta con el soporte de tu hosting. Puede ser un problema en el servidor que ellos deben resolver.

[TIP] Guarda una copia de seguridad regular de tu base de datos. Así, si algo grave ocurre, puedes restaurarla fácilmente.

Prevención: cómo evitar futuros errores de conexión

Realiza copias de seguridad semanales de tu base de datos.
Actualiza WordPress, temas y plugins solo desde el panel de administración.
No modifiques archivos sensibles (como wp-config.php) sin saber lo que haces.
Elige un hosting confiable con buen soporte técnico y recursos suficientes para tu tráfico.
Monitorea el límite de conexiones si tu sitio tiene mucho tráfico.

Conclusión

El error de conexión a la base de datos en WordPress puede ser alarmante, pero en la gran mayoría de los casos tiene una solución sencilla. Con esta guía paso a paso, podrás diagnosticar y resolver el problema tú mismo, sin necesidad de conocimientos avanzados.

Recuerda: lo primero es verificar las credenciales, luego comprobar que el servidor de base de datos esté activo y, si todo falla, reparar las tablas. Si el problema persiste, tu hosting tiene la última palabra.

[INFO] Si usas Syspanel (puerto 2106), recuerda que todas las herramientas de gestión de bases de datos están disponibles desde ese panel. No dudes en explorarlo.

Ahora ya sabes cómo enfrentarte a este error. ¡Manos a la obra y recupera tu sitio web!