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

¿Tu sitio WordPress de repente muestra el temido mensaje "Error al establecer la conexión con la base de datos"? No entres en pánico. Este es uno de los errores más comunes en WordPress, pero también uno de los más fáciles de solucionar si sabes por dónde empezar.

En este artículo, te guiaremos paso a paso para identificar y resolver este problema. Actuarás como tu propio SysAdmin, incluso si no tienes experiencia técnica. Vamos a desglosar las causas más frecuentes y las soluciones más efectivas.

[INFO] Este error no significa que hayas perdido tus datos. La base de datos suele estar intacta; solo necesitas restablecer la conexión.

¿Qué significa "Error al establecer la conexión con la base de datos"?

WordPress utiliza una base de datos (normalmente MySQL o MariaDB) para almacenar todo tu contenido: entradas, páginas, comentarios, configuraciones de plugins, etc. Cuando visitas tu web, WordPress intenta conectarse a esa base de datos para mostrar la información. Si la conexión falla, el sitio no puede cargar nada y muestra ese error.

Las causas principales suelen ser:

Credenciales incorrectas en el archivo de configuración wp-config.php.
La base de datos o el usuario han sido eliminados o modificados (por error, tras una migración o al reinstalar algo).
El servidor de base de datos está caído o sobrecargado.
Problemas con el plugin de caché o algún plugin conflictivo.
Corrupción en la base de datos (menos común, pero posible).

Preparación: Accede a tu Panel de Control (SysPanel / cPanel)

Antes de empezar, necesitas acceder al lugar donde se aloja tu web. La mayoría de los tutoriales asumen que usas cPanel, pero si tu hosting usa Syspanel (el antiguo HestiaCP), el proceso es muy similar.

[TIP] Si usas Syspanel, la dirección de acceso suele ser https://tudominio.com:2106. Usa tus credenciales de administrador del hosting para iniciar sesión.

Soluciones Paso a Paso

Sigue estos pasos en orden. No los saltes, ya que el problema puede ser más simple de lo que parece.

1. Verifica el Estado del Servidor de Base de Datos (MySQL/MariaDB)

A veces el problema no es tuyo, sino del servidor. Si el servicio de base de datos está detenido, ningún sitio web en ese servidor funcionará.

Si tienes acceso a la terminal (SSH):

Conéctate a tu servidor por SSH.

Ejecuta el siguiente comando para verificar el estado del servicio:

systemctl status mysql
# o si usas MariaDB:
systemctl status mariadb

Si el servicio aparece como inactive (dead) o failed, debes reiniciarlo:
```
systemctl restart mysql
# o
systemctl restart mariadb
```
Vuelve a cargar tu web. Si se soluciona, el problema era un servicio caído. Si no, continúa.

Si no tienes acceso SSH (la mayoría de los usuarios):

Contacta con tu proveedor de hosting y pregunta si el servicio MySQL está funcionando correctamente. Es su responsabilidad mantenerlo activo.

2. Revisa el Archivo `wp-config.php` (El culpable más común)

Este archivo contiene las credenciales de acceso a la base de datos. Si se han cambiado o están mal escritas, la conexión falla.

¿Cómo encontrarlo?

Accede a tu panel de control (Syspanel, cPanel, etc.).
Busca la opción "Administrador de Archivos" (File Manager).
Navega hasta la carpeta raíz de tu instalación de WordPress (normalmente public_html o htdocs).
Busca el archivo llamado wp-config.php. No lo borres, solo edítalo.

¿Qué buscar?
Dentro del archivo, verás líneas como estas:

define('DB_NAME', 'nombre_de_tu_base');
define('DB_USER', 'usuario_de_la_base');
define('DB_PASSWORD', 'contraseña_secreta');
define('DB_HOST', 'localhost');

Solución:

Verifica que el nombre de la base de datos (DB_NAME) y el usuario (DB_USER) sean correctos. Puedes encontrarlos en tu panel de control, en la sección "Bases de Datos MySQL".
Verifica la contraseña (DB_PASSWORD). Si la has cambiado recientemente, actualízala aquí.
Verifica el host (DB_HOST). Normalmente es localhost, pero algunos hostings usan una dirección IP (ej. 127.0.0.1) o un nombre como mysql.tudominio.com. Si no estás seguro, consulta la documentación de tu hosting.
Cuidado con los caracteres especiales. Si tu contraseña contiene caracteres como $, \, ' o ", WordPress puede interpretarlos mal. Lo más seguro es cambiarla por una sin esos caracteres o usar un editor de texto que no los escape.

[WARNING] No edites este archivo con un procesador de texto (Word, Pages). Usa el editor de texto del panel de control (File Manager) o un editor de código como Notepad++.

3. Repara la Base de Datos (Si está corrupta)

A veces la base de datos se "rompe" debido a un plugin defectuoso o una mala actualización. WordPress tiene una herramienta de reparación integrada.

Activa el modo de reparación: Añade la siguiente línea justo antes de la línea que dice /* That's all, stop editing! Happy blogging. */ en tu archivo wp-config.php:
```
define('WP_ALLOW_REPAIR', true);
```
Accede a la herramienta: Abre tu navegador y ve a esta URL (reemplaza tudominio.com con tu dominio real):
https://tudominio.com/wp-admin/maint/repair.php
Realiza la reparación: Verás dos opciones:
- "Reparar base de datos" (más rápida).
- "Reparar y optimizar base de datos" (recomendada, aunque puede tardar un poco más).
  Haz clic en el botón correspondiente.
Elimina la línea de seguridad: Una vez terminado, vuelve a tu archivo wp-config.php y BORRA la línea que añadiste (define('WP_ALLOW_REPAIR', true);). Si no lo haces, cualquiera podría acceder a esa URL y dañar tu web.

[INFO] Si no puedes acceder a la URL de reparación, puede que tengas un problema de permisos o que el servidor esté muy mal. En ese caso, intenta desde phpMyAdmin (paso siguiente).

4. Usa phpMyAdmin para Verificar y Reparar

phpMyAdmin es una herramienta web para gestionar bases de datos. Es más segura que el método anterior si tienes acceso a ella.

Accede a phpMyAdmin: Desde tu panel de control (Syspanel, cPanel), busca el icono de phpMyAdmin.
Selecciona tu base de datos: En la columna de la izquierda, haz clic en el nombre de la base de datos de tu WordPress.
Selecciona todas las tablas: En la parte inferior de la lista de tablas, haz clic en "Marcar todas" o "Seleccionar todo".
Elige "Reparar tabla": En el menú desplegable que dice "Con seleccionados", elige la opción "Reparar tabla". phpMyAdmin ejecutará un comando REPAIR TABLE.
Verifica el resultado: Deberías ver un mensaje verde de "OK" para cada tabla. Si ves algún error, anótalo y búscalo en Google, o contacta con tu hosting.

5. Comprueba los Límites de Conexión a la Base de Datos

Si tu web recibe mucho tráfico o tienes muchos plugins que hacen consultas a la base de datos, puedes exceder el límite de conexiones simultáneas permitidas por tu hosting.

Solución:

Aumenta el límite de conexiones (si tienes acceso): Si eres el administrador del servidor, puedes modificar el archivo de configuración de MySQL (/etc/mysql/my.cnf o /etc/my.cnf) y aumentar el valor de max_connections. Luego reinicia MySQL.
Reduce la carga: Si no tienes acceso al servidor, la solución es reducir el número de plugins activos o migrar a un plan de hosting más potente.
Usa un plugin de caché: Un buen plugin de caché (como W3 Total Cache o WP Super Cache) reduce drásticamente las consultas a la base de datos, ya que sirve páginas estáticas.

6. Desactiva Plugins y Temas (Si puedes acceder al wp-admin)

A veces un plugin conflictivo es el culpable. Si el error te permite acceder al panel de administración (/wp-admin), intenta esto:

Desactiva todos los plugins.
Si el error desaparece, reactívalos uno por uno hasta encontrar el que causa el problema.
Si no puedes acceder al wp-admin, tendrás que desactivar los plugins manualmente:
- Accede al Administrador de Archivos de tu panel de control.
- Navega a la carpeta wp-content/plugins.
- Renombra la carpeta de cada plugin (por ejemplo, de akismet a akismet_desactivado). Esto los desactiva.
- Si el error se soluciona, sabes que uno de ellos era el problema.

7. Verifica los Permisos de Archivos y Carpetas

Aunque es menos común, los permisos incorrectos pueden impedir que WordPress lea el archivo wp-config.php.

Los permisos correctos suelen ser:

Carpetas: 755
Archivos: 644
Archivo wp-config.php: 600 (más seguro) o 644.

Puedes cambiarlos desde el Administrador de Archivos de tu panel. Selecciona el archivo o carpeta, haz clic derecho y elige "Permisos" o "Change Permissions".

¿Qué hago si nada funciona?

Si has seguido todos los pasos y el error persiste, el problema puede ser más complejo:

Error en el servidor DNS: A veces el nombre del servidor de base de datos (DB_HOST) no se resuelve correctamente. Prueba a cambiarlo por 127.0.0.1 en lugar de localhost.
Firewall o seguridad del hosting: Algunos hostings bloquean conexiones externas a la base de datos. Asegúrate de que tu IP esté en la lista blanca (whitelist) del firewall de tu hosting.
Problema de red interna: Si tu web y la base de datos están en servidores diferentes (por ejemplo, en una arquitectura de nube), puede haber un problema de comunicación entre ellos. Contacta con tu soporte técnico.

En este punto, la mejor opción es contactar con el equipo de soporte de tu hosting. Diles que has revisado las credenciales, el estado del servicio y has reparado la base de datos, y que el error persiste. Ellos podrán ver los logs del servidor y detectar el problema raíz.

Preguntas Frecuentes (FAQ)

¿Perderé mis datos si la base de datos está corrupta?

No necesariamente. La reparación (paso 3 y 4) suele restaurar la integridad de los datos. Siempre es recomendable tener una copia de seguridad, pero la reparación no borra contenido.

¿Puedo solucionar esto sin acceso al panel de control?

Es muy difícil. Necesitas al menos acceso al Administrador de Archivos o a phpMyAdmin para editar wp-config.php o reparar la base de datos. Si no tienes acceso, contacta a tu hosting.

¿Por qué aparece este error después de migrar mi web?

Es muy común. Al migrar, las credenciales de la base de datos cambian. El error suele deberse a que el archivo wp-config.php aún tiene las credenciales viejas. Edítalo con los nuevos datos de tu nuevo hosting.

¿Un plugin de seguridad puede causar esto?

Sí. Algunos plugins de seguridad (como Wordfence) pueden bloquear temporalmente la conexión a la base de datos si detectan un comportamiento sospechoso. Desactívalos temporalmente para probar.

¿El error "Conexión perdida con la base de datos" es lo mismo que "Error al establecer la conexión"?

Sí, son sinónimos. Ambos indican que WordPress no puede comunicarse con la base de datos.

[TIP] La mejor defensa contra este error es mantener una copia de seguridad reciente de tu base de datos y archivos. Así, si todo falla, puedes restaurar tu sitio en minutos.

¡Esperamos que este artículo te haya ayudado a resolver el problema! Si sigues teniendo dudas, recuerda que siempre puedes contar con el soporte técnico de tu proveedor de hosting.