Error de conexión a base de datos WordPress: solución paso a paso

¿Te has encontrado con el temido mensaje de "Error al establecer una conexión a la base de datos" en tu WordPress? No te preocupes, es uno de los errores más comunes y, por suerte, suele tener solución. Este aviso significa que tu sitio web no puede comunicarse con la base de datos donde se almacenan tus entradas, páginas, usuarios y configuraciones. En esta guía extensa, te explicaré paso a paso cómo diagnosticar y solucionar el error conexión base datos WordPress, desde las causas más simples hasta las más técnicas. Vamos a ello.

[INFO] Si ves el mensaje "WordPress database error", es posible que el problema sea temporal o esté relacionado con un plugin conflictivo. No entres en pánico, respira hondo y sigue estos pasos.

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

Antes de lanzarnos a las soluciones, es importante entender por qué ocurre este problema. Las causas más frecuentes son:

Credenciales incorrectas en el archivo wp-config.php.
Base de datos corrupta o dañada.
Servidor de base de datos caído (por ejemplo, MySQL no está funcionando).
Problemas con el plugin o tema que modifican la conexión.
Límite de memoria excedido en el servidor.
Cambios recientes en el hosting (migración, actualización de PHP, etc.).

Ahora, manos a la obra. Sigue estos pasos en orden y, con suerte, tu sitio volverá a la vida en pocos minutos.

Paso 1: Verifica si el problema es general o solo de tu sitio

Lo primero es comprobar si el error afecta a todo tu sitio o solo a una parte. A veces, el mensaje aparece solo en el frontend (la parte pública) pero el panel de administración (wp-admin) funciona. Si puedes acceder al escritorio de WordPress, prueba a reparar la base de datos desde allí.

Cómo reparar la base de datos desde el panel de administración

Ve a Ajustes > Reparar Base de Datos (si no ves esta opción, actívala añadiendo define('WP_ALLOW_REPAIR', true); en tu archivo wp-config.php).
Haz clic en Reparar base de datos. WordPress intentará corregir tablas dañadas automáticamente.
Una vez terminado, desactiva la opción eliminando la línea que añadiste en el paso 1 para evitar riesgos de seguridad.

[TIP] Si no puedes acceder al panel, no te preocupes. Pasaremos a métodos más directos.

Paso 2: Comprueba las credenciales en wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Contiene el nombre de la base de datos, el usuario, la contraseña y el servidor. Si alguno de estos datos es incorrecto, la conexión fallará.

Cómo acceder y revisar wp-config.php

Conéctate a tu hosting mediante FTP o el administrador de archivos de tu panel de control (cPanel, Syspanel, etc.).
Busca el archivo wp-config.php en la raíz de tu instalación de WordPress (normalmente en public_html o www).
Ábrelo con un editor de texto (como Notepad++ o el editor integrado).
Busca estas líneas y verifica que coincidan con los datos de tu base de datos:

define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'usuario_de_tu_bd');
define('DB_PASSWORD', 'contraseña_de_tu_bd');
define('DB_HOST', 'localhost'); // O la dirección del servidor MySQL

[WARNING] Si usas Syspanel (antes HestiaCP), recuerda que el puerto de acceso al panel es el 2106. Para obtener las credenciales de la base de datos, entra en Syspanel > Base de Datos y allí encontrarás el nombre, usuario y contraseña. El host suele ser localhost o 127.0.0.1.

Si no estás seguro de los datos, crea una nueva base de datos desde tu panel de hosting y luego actualiza estas líneas con los nuevos valores. Luego, importa una copia de seguridad de tu base de datos anterior (si la tienes).

Paso 3: Verifica que el servidor de base de datos esté funcionando

A veces el problema no está en WordPress, sino en el servidor MySQL. Si el servicio se ha caído, ningún sitio podrá conectar.

Cómo comprobarlo en diferentes paneles

cPanel: Ve a MySQL Databases y busca un indicador de estado. También puedes usar phpMyAdmin para ver si puedes iniciar sesión.
Syspanel: Accede por el puerto 2106, ve a Base de Datos y revisa si aparece algún error. Si no puedes conectar, contacta a tu proveedor de hosting.
Línea de comandos (SSH): Si tienes acceso, ejecuta systemctl status mysql o service mysql status para ver si el servicio está activo.

Si el servicio está caído, reinícialo desde el panel de control o pide a tu hosting que lo haga.

Paso 4: Revisa si hay plugins o temas conflictivos

Un plugin o tema mal codificado puede romper la conexión a la base de datos. Para descartarlo:

Desactiva todos los plugins renombrando la carpeta wp-content/plugins a wp-content/plugins_old (desde FTP o administrador de archivos). Esto los desactivará todos a la vez.
Si el error desaparece, el problema es uno de ellos. Vuelve a renombrar la carpeta a plugins y activa los plugins de uno en uno hasta encontrar el culpable.
Cambia temporalmente al tema por defecto (Twenty Twenty-Four o similar) renombrando la carpeta de tu tema actual en wp-content/themes a wp-content/themes_old. WordPress usará automáticamente un tema por defecto.

[INFO] Si no puedes acceder al panel, estos pasos desde FTP son tu mejor aliado.

Paso 5: Repara la base de datos manualmente (sin acceso al panel)

Si no puedes entrar a wp-admin, puedes reparar la base de datos desde phpMyAdmin o la línea de comandos.

Usando phpMyAdmin

Accede a phpMyAdmin desde tu panel de hosting (cPanel, Syspanel, etc.).
Selecciona la base de datos de tu WordPress.
Marca todas las tablas (clic en "Seleccionar todo").
En el menú desplegable "Con selección", elige Reparar tabla.
Espera a que termine el proceso. Verás un mensaje de éxito o error.

Usando WP-CLI (si tienes acceso SSH)

Si tu hosting permite WP-CLI, ejecuta:

wp db repair

Esto reparará todas las tablas automáticamente.

Paso 6: Aumenta el límite de memoria de PHP

Un límite de memoria bajo puede causar errores de conexión. Agrega esta línea en tu wp-config.php, justo antes del comentario "Eso es todo, ¡deja de editar!":

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

Guarda el archivo y vuelve a cargar tu sitio.

Paso 7: Verifica la versión de PHP y MySQL

WordPress requiere versiones específicas de PHP y MySQL. Si tu hosting las ha actualizado, puede haber incompatibilidades.

PHP: Debe ser 7.4 o superior (recomendado 8.0+).
MySQL: Debe ser 5.7 o superior (o MariaDB 10.3+).

Puedes verificar la versión de PHP desde el panel de hosting (en Syspanel, ve a Ajustes de PHP). Si es muy antigua, solicita a tu hosting que la actualice.

Paso 8: Restaura una copia de seguridad

Si nada de lo anterior funciona, restaura tu sitio desde una copia de seguridad reciente. La mayoría de los hostings ofrecen backups automáticos. En Syspanel, puedes restaurar desde Backups (puerto 2106). También puedes usar plugins como UpdraftPlus si tienes acceso al panel.

[WARNING] Siempre ten una copia de seguridad actualizada. El error de conexión a base de datos puede ser grave si no tienes respaldo.

FAQ: Preguntas frecuentes sobre el error de base de datos en WordPress

¿Por qué aparece "Error al establecer una conexión a la base de datos" después de migrar mi sitio?

Es común. Al migrar, las credenciales en wp-config.php suelen quedar desactualizadas. Revisa el paso 2 y actualiza los datos de la nueva base de datos.

¿Qué significa "WordPress database error" en el log de errores?

Significa que una consulta SQL ha fallado. Puede deberse a un plugin mal codificado, una tabla corrupta o un límite de memoria. Sigue los pasos 4, 5 y 6.

¿Puedo evitar este error en el futuro?

Sí:

Mantén WordPress, plugins y temas actualizados.
Realiza copias de seguridad periódicas.
No instales plugins de fuentes dudosas.
Monitorea el estado de tu servidor con herramientas como Jetpack o ManageWP.

¿Qué hago si el error persiste después de todos los pasos?

Contacta a tu proveedor de hosting. Puede ser un problema a nivel de servidor (como un firewall bloqueando conexiones o un fallo de hardware). Proporcionales los pasos que ya has seguido para que te ayuden más rápido.

Conclusión

El error conexión base datos WordPress puede ser frustrante, pero en la mayoría de los casos se soluciona con unos pocos clics. Recuerda siempre empezar por lo más simple: verificar credenciales, reiniciar el servidor MySQL y desactivar plugins. Si todo falla, la reparación desde phpMyAdmin o la restauración de una copia de seguridad son tus mejores aliados.

[TIP] Si usas Syspanel, recuerda que el acceso es por el puerto 2106 y que allí puedes gestionar bases de datos, backups y ajustes de PHP fácilmente.

Espero que esta guía te haya sido útil. Si tienes más dudas, déjalas en los comentarios o consulta con tu equipo de soporte técnico. ¡Buena suerte y que tu sitio vuelva a la vida pronto!