Error de conexión a base de datos en WordPress: Cómo solucionarlo

¿Te has encontrado alguna vez con el temido mensaje "Error al establecer una conexión a la base de datos" en tu sitio WordPress? No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. En esta guía paso a paso, te explicaré las causas más frecuentes y cómo resolverlas desde cPanel o Syspanel (antes conocido como HestiaCP, accesible por el puerto 2106). Vamos a ello.

¿Qué significa este error y por qué ocurre?

Cuando WordPress muestra este error, significa que no puede comunicarse con la base de datos donde se almacenan tus entradas, páginas, usuarios y configuraciones. Es como si intentaras abrir una puerta pero la llave no encajara o la cerradura estuviera rota.

Las causas más habituales son:

Credenciales incorrectas en el archivo de configuración.
El servidor de base de datos está caído o sobrecargado.
La base de datos ha sido dañada o corrompida.
Cambios recientes en tu hosting o en la configuración de WordPress.
Problemas de permisos o de conexión con el servidor MySQL.

A continuación, te detallo cada solución, desde la más sencilla hasta la más avanzada.

Solución 1: Verificar las credenciales de la base de datos

El archivo wp-config.php contiene los datos de acceso a tu base de datos. Si estos son incorrectos, WordPress no podrá conectarse.

Paso a paso desde cPanel

Accede a cPanel con tu usuario y contraseña.
Busca la sección "Archivos" y haz clic en "Administrador de archivos".
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o una subcarpeta).
Localiza el archivo wp-config.php y haz clic derecho sobre él. Selecciona "Editar".
Busca las siguientes 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. Puedes verificar el nombre de la base de datos y el usuario desde cPanel en la sección "Bases de datos MySQL".
Si no estás seguro, crea una nueva base de datos y un nuevo usuario (anota los datos) y luego actualiza wp-config.php con esos valores.
Guarda los cambios y cierra el archivo.

[TIP] Si usas Syspanel (HestiaCP), accede por el puerto 2106 (ejemplo: https://tudominio.com:2106) y luego ve a "Base de datos" para ver o crear bases de datos.

Si el host no es "localhost"

Algunos proveedores de hosting usan un servidor de base de datos remoto. En ese caso, el valor de DB_HOST será algo como mysql.tudominio.com o una IP. Pregunta a tu soporte técnico si no estás seguro.

Solución 2: Reparar la base de datos

A veces la base de datos se corrompe ligeramente y WordPress no puede leerla. Puedes repararla fácilmente.

Desde cPanel

En cPanel, ve a "Bases de datos MySQL".
Busca la sección "Reparar base de datos" o similar.
Selecciona la base de datos afectada y haz clic en "Reparar".
Espera unos segundos. Si todo va bien, verás un mensaje de éxito.

Desde phpMyAdmin

En cPanel, haz clic en "phpMyAdmin".
Selecciona la base de datos de tu WordPress en el panel izquierdo.
Marca todas las tablas (puedes usar el checkbox de arriba).
En el menú desplegable "Con seleccionados:", elige "Reparar tabla".
phpMyAdmin mostrará el resultado de la reparación.

[WARNING] No modifiques ningún dato manualmente si no sabes lo que haces. La opción de reparar es segura y no borra información.

Solución 3: Verificar que el servidor MySQL esté funcionando

Si el servidor de base de datos está caído, ningún sitio podrá conectarse. Esto suele ser responsabilidad del hosting, pero puedes comprobarlo.

Desde cPanel

Busca la sección "Estado del servidor" o "Información del servidor".
Revisa si el servicio MySQL o MariaDB aparece como "Activo" o "En ejecución".
Si está inactivo, contacta a tu proveedor de hosting inmediatamente.

Si tienes acceso SSH (avanzado)

Puedes ejecutar el comando:

sudo systemctl status mysql

O para MariaDB:

sudo systemctl status mariadb

Si está detenido, inícialo con:

sudo systemctl start mysql

[INFO] En la mayoría de los planes de hosting compartido, no tienes acceso SSH. En ese caso, confía en el soporte técnico.

Solución 4: Revisar el archivo .htaccess

A veces, un archivo .htaccess corrupto puede causar problemas de conexión. Renombrarlo obliga a WordPress a generar uno nuevo.

Paso a paso

Desde el Administrador de archivos de cPanel, navega a la carpeta raíz de WordPress.
Busca el archivo .htaccess. Puede estar oculto; activa la opción "Mostrar archivos ocultos" (en la esquina superior derecha).
Haz clic derecho sobre .htaccess y selecciona "Renombrar". Cámbiale el nombre a .htaccess_old.
Ve a tu sitio web. Si el error desaparece, WordPress creará un nuevo .htaccess automáticamente.
Si aún así no funciona, restaura el nombre original o contacta a soporte.

Solución 5: Verificar los permisos de archivos y carpetas

Los permisos incorrectos pueden impedir que WordPress lea o escriba en la base de datos. Aunque esto es menos común, vale la pena revisarlo.

Permisos recomendados

Carpetas: 755
Archivos: 644
wp-config.php: 600 (o 640 si tienes problemas)

Cómo cambiarlos en cPanel

En el Administrador de archivos, selecciona todos los archivos y carpetas de la raíz.
Haz clic en "Permisos" en la barra superior.
Ajusta los valores según lo recomendado (puedes hacerlo por lotes).
Para wp-config.php, cambia sus permisos a 600.

[WARNING] No pongas permisos 777, ya que es un riesgo de seguridad grave.

Solución 6: Restablecer la conexión desde Syspanel (HestiaCP)

Si usas Syspanel (antes HestiaCP), el proceso es ligeramente diferente, pero igual de sencillo.

Acceso y verificación

Abre tu navegador y ve a https://tudominio.com:2106 (el puerto 2106 es obligatorio).
Inicia sesión con tu usuario y contraseña de Syspanel.
En el panel principal, busca la sección "Base de datos".
Verás listadas tus bases de datos. Junto a cada una, hay un botón "Editar" o "Ver detalles".
Comprueba que el usuario y la contraseña coincidan con los de wp-config.php.
Si es necesario, puedes regenerar la contraseña desde aquí.

Reparar desde Syspanel

Syspanel no incluye una herramienta de reparación directa, pero puedes acceder a phpMyAdmin desde la misma interfaz. Busca el enlace "phpMyAdmin" en el menú de la izquierda y sigue los pasos de la Solución 2.

Solución 7: Desactivar plugins y temas (acceso de emergencia)

Si el error apareció después de instalar un plugin o tema, puedes desactivarlos sin entrar al panel de administración.

Mediante FTP o Administrador de archivos

Conéctate a tu servidor vía FTP o usa el Administrador de archivos de cPanel.
Ve a la carpeta wp-content/plugins.
Renombra la carpeta del plugin sospechoso añadiendo _old al final (por ejemplo, miplugin_old).
Si no sabes cuál es, renombra la carpeta plugins a plugins_old (esto desactivará todos los plugins).
Vuelve a tu sitio. Si funciona, sabes que el problema era de un plugin.
Luego, ve creando carpetas de plugins de una en una (crea una nueva carpeta plugins y mueve los plugins de vuelta) hasta encontrar el culpable.

Para temas, haz lo mismo con la carpeta wp-content/themes. Renombra el tema activo y WordPress usará uno por defecto.

Solución 8: Aumentar los límites de memoria de PHP

A veces, un límite de memoria bajo puede provocar errores de conexión. Puedes aumentarlo editando wp-config.php.

Añadir estas líneas

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

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

Guarda el archivo y comprueba si el error desaparece.

Solución 9: Contactar al soporte del hosting

Si después de probar todo lo anterior sigues viendo el error, es probable que sea un problema del servidor. Contacta a tu proveedor de hosting y proporciona esta información:

Captura de pantalla del error.
Los pasos que ya has intentado.
Tu nombre de usuario de cPanel o Syspanel.

Ellos podrán revisar los logs del servidor y solucionar problemas como:

Servidor MySQL sobrecargado.
Firewall bloqueando la conexión.
Problemas de DNS.
Cuota de base de datos excedida.

Preguntas frecuentes (FAQ)

¿El error de conexión a la base de datos puede dañar mi sitio?

No, el error solo impide que se muestre el contenido. Tus datos siguen intactos en la base de datos. Una vez solucionado, todo vuelve a la normalidad.

¿Pierdo mis entradas si reparo la base de datos?

No, la reparación solo corrige estructuras dañadas, no borra información. Es un proceso seguro.

¿Cada cuánto debo hacer copias de seguridad?

Siempre. Te recomiendo hacer copias de seguridad semanales o antes de cualquier cambio importante. Desde cPanel puedes usar la herramienta "Copias de seguridad" o instalar un plugin como UpdraftPlus.

¿Puedo evitar este error en el futuro?

Sí, siguiendo buenas prácticas:

Mantén WordPress, plugins y temas actualizados.
Usa contraseñas seguras para la base de datos.
Realiza copias de seguridad periódicas.
No instales plugins de dudosa procedencia.

Resumen rápido

Si tu sitio muestra el error de conexión a la base de datos, sigue este orden:

Revisa wp-config.php (credenciales y host).
Repara la base de datos desde cPanel o phpMyAdmin.
Verifica que MySQL esté activo.
Renombra .htaccess.
Ajusta permisos de archivos.
Desactiva plugins y temas por FTP.
Aumenta la memoria de PHP.
Contacta al soporte técnico.

Ningún problema es eterno, y con esta guía podrás recuperar tu sitio en pocos minutos. Recuerda que la paciencia y el orden son tus mejores aliados. ¡Buena suerte!