Solucionar error de conexión a base de datos en WordPress

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

Este es, sin duda, uno de los errores más temidos por cualquier persona que tenga un sitio web en WordPress. Ver un mensaje como "Error al establecer conexión con la base de datos" en lugar de tu página principal puede ser desconcertante, pero no entres en pánico. Es un problema muy común y, en la mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

Este error indica que WordPress no puede comunicarse con la base de datos donde se almacenan tus publicaciones, páginas, comentarios y configuraciones. Sin esa conexión, tu sitio no puede funcionar. Las causas pueden variar desde un simple dato mal escrito en un archivo de configuración, hasta un problema en el servidor de bases de datos o un ataque malintencionado.

En esta guía completa, te explicaré paso a paso cómo diagnosticar y arreglar este error. Vamos a ir desde las soluciones más básicas hasta las más avanzadas, pensadas para usuarios de todos los niveles. Al final, tendrás un plan de acción claro para que tu sitio web vuelva a estar en línea en cuestión de minutos.

Primeros pasos: Diagnóstico inicial del error base datos wordpress

Antes de empezar a tocar archivos o reiniciar servicios, es fundamental entender qué está pasando. El mensaje de error puede aparecer de diferentes formas, y eso nos da pistas sobre la causa.

¿El error es solo en el panel de administración o en todo el sitio?

Accede a tudominio.com/wp-admin. Si puedes ver la pantalla de inicio de sesión, el problema es intermitente o está relacionado con un plugin específico. Si el error aparece también en el panel de administración, el problema es más general y afecta a la conexión con la base de datos en su totalidad.

Revisa si el problema es generalizado

A veces el problema no es con tu sitio, sino con tu proveedor de hosting. Una forma rápida de comprobarlo es ver si otros sitios web en el mismo servidor (si tienes varios) están funcionando. Si todos fallan, es muy probable que el servidor de bases de datos se haya caído o esté en mantenimiento.

[INFO] Si tu sitio está en un hosting compartido, el proveedor suele publicar el estado del servicio en su página web o en su panel de control. Antes de hacer nada, échale un vistazo.

Solución 1: Verifica los datos en el archivo wp-config.php

Esta es la causa más común y la primera que debes revisar. WordPress guarda la información de conexión a la base de datos en un archivo llamado wp-config.php. Si estos datos son incorrectos, WordPress no podrá conectarse.

¿Cómo acceder y editar el archivo?

Accede a tu panel de control de hosting (cPanel, Plesk, Syspanel o similar).
Busca el Administrador de Archivos (File Manager).
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o htdocs).
Localiza el archivo wp-config.php y haz clic derecho para Editar.

¿Qué debo buscar y corregir?

Dentro del archivo, busca estas 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' );

Verifica que estos valores sean absolutamente correctos. Un error tipográfico en el nombre de usuario, la contraseña o el nombre de la base de datos causará este error.

[TIP] Si no estás seguro de estos datos, puedes encontrarlos en el panel de control de tu hosting. Busca la sección de "Bases de datos MySQL" o similar. En Syspanel, puedes acceder al puerto 2106 para gestionar tus bases de datos y usuarios.

El caso especial de DB_HOST

En la mayoría de los casos, DB_HOST es localhost. Sin embargo, algunos proveedores de hosting utilizan una dirección de servidor específica (como mysql.tudominio.com). Si tu proveedor te ha dado una dirección concreta, debes usarla aquí. Cambiar localhost por otra cosa sin necesidad puede romper la conexión.

[WARNING] Si has cambiado recientemente la contraseña de tu base de datos desde el panel de control, asegúrate de actualizarla también en este archivo. Es un error muy común olvidarse de este paso.

Solución 2: Repara la base de datos con la herramienta integrada de WordPress

WordPress tiene una utilidad oculta que puede reparar automáticamente problemas menores en la base de datos. Es un primer paso excelente antes de entrar en soluciones más técnicas.

Pasos para activar la reparación

Edita el archivo wp-config.php como hicimos antes.
Añade la siguiente 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.
Ahora, visita esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php
Haz clic en el botón "Reparar base de datos" y espera a que termine.

Después de la reparación

Una vez que la reparación haya terminado, es muy importante que elimines la línea que añadiste al archivo wp-config.php. Dejar esa línea activa es un riesgo de seguridad, ya que cualquiera podría intentar reparar tu base de datos.

[WARNING] No olvides eliminar la línea define('WP_ALLOW_REPAIR', true); después de usarla. Es un agujero de seguridad que no debes dejar abierto.

Solución 3: Comprueba si el servidor de base de datos está activo

Si los datos de configuración son correctos y la reparación no funciona, el problema puede estar en el servidor de bases de datos en sí.

¿Cómo saber si el servidor MySQL/MariaDB está corriendo?

Si tienes acceso a un panel de control como cPanel o Syspanel, busca la sección de "Servicios" o "Procesos". Ahí deberías poder ver el estado de MySQL o MariaDB. Si aparece como "Detenido", intenta iniciarlo.

Acceso por línea de comandos (SSH)

Si eres más avanzado y tienes acceso SSH, puedes usar estos comandos:

# Para sistemas con systemd (la mayoría de las distribuciones modernas)
sudo systemctl status mysql
# o
sudo systemctl status mariadb

# Para sistemas más antiguos
sudo service mysql status

Si el servicio está inactivo, puedes iniciarlo con:

sudo systemctl start mysql
# o
sudo systemctl start mariadb

[INFO] Si estás en un hosting compartido, no tendrás acceso SSH. En ese caso, contacta con el soporte de tu proveedor y diles que crees que el servidor de bases de datos está caído. Ellos podrán reiniciarlo por ti.

Solución 4: Optimiza y repara las tablas de la base de datos

A veces, las tablas de la base de datos pueden estar corruptas o fragmentadas, lo que impide la conexión. Puedes optimizarlas desde el panel de control.

Usando phpMyAdmin

Accede a phpMyAdmin desde el panel de control de tu hosting (suele estar en la sección de bases de datos).
Selecciona la base de datos de tu WordPress en el panel izquierdo.
Haz clic en la pestaña "Marcar todas" o selecciona todas las tablas.
En el menú desplegable de "Con selección", elige "Optimizar tablas".
Repite el proceso, pero esta vez elige "Reparar tablas".

Usando Syspanel

Si tu hosting utiliza Syspanel, el proceso es similar. Accede al puerto 2106, entra a tu panel y busca la sección de bases de datos. Desde ahí, normalmente puedes gestionar las tablas de forma visual.

[TIP] Este proceso es seguro y no borrará datos. Solo optimiza y arregla las estructuras internas de las tablas.

Solución 5: Revisa los permisos de la base de datos

Un usuario de base de datos necesita permisos específicos para leer, escribir y modificar los datos. Si estos permisos se han cambiado o son incorrectos, WordPress no podrá conectarse.

¿Cómo comprobar los permisos?

Ve a la sección de "Bases de datos MySQL" en tu panel de control.
Busca el usuario que estás utilizando en wp-config.php.
Asegúrate de que este usuario esté asociado a la base de datos correcta.
Verifica que tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, etc.). La opción más fácil es marcar "Todos los privilegios".

[WARNING] Si acabas de crear un nuevo usuario y base de datos, asegúrate de haberlos vinculado correctamente. Es un error común crear ambos pero olvidar asignar el usuario a la base de datos.

Solución 6: El problema puede ser un plugin o tema

Aunque es menos común, un plugin o tema mal codificado puede causar conflictos que resulten en el error de conexión.

¿Cómo probar esta teoría?

Desactiva todos los plugins: Accede a tu servidor por FTP o el Administrador de Archivos. Renombra la carpeta wp-content/plugins a wp-content/plugins_backup. Esto desactiva todos los plugins de golpe. Si el sitio funciona, el problema es uno de ellos.
Revierte a un tema por defecto: De manera similar, renombra la carpeta del tema activo en wp-content/themes. WordPress usará automáticamente un tema por defecto si no encuentra el activo.

[INFO] Para renombrar una carpeta, simplemente haz clic derecho sobre ella y selecciona "Renombrar". No necesitas cambiar el contenido, solo el nombre de la carpeta.

Si el sitio vuelve a funcionar, tendrás que reactivar los plugins o temas uno por uno para identificar el culpable.

Solución 7: Aumenta el límite de memoria de PHP

A veces, el error puede aparecer si WordPress se queda sin memoria. Esto es más común en sitios con muchos plugins o un volumen alto de tráfico.

¿Cómo aumentar el límite de memoria?

Edita el archivo wp-config.php.
Añade esta línea antes del comentario final:
```
define('WP_MEMORY_LIMIT', '256M');
```
Guarda el archivo y comprueba si el error se resuelve.

Si no funciona, también puedes intentar editando el archivo .htaccess en la raíz de tu instalación de WordPress y añadiendo:

php_value memory_limit 256M

[TIP] Un límite de 256M es un buen punto de partida. Si tu sitio es muy complejo, puedes probar con 512M, pero no es recomendable ir más allá sin una razón justificada.

Solución 8: Contacta con tu proveedor de hosting

Si has probado todos los pasos anteriores y el error persiste, es hora de llamar a los profesionales. El problema puede estar en el servidor, en un firewall, o en una configuración de red que no puedes ver desde tu panel de control.

¿Qué información debo dar al soporte?

Para que te ayuden rápido, ten a mano:

El mensaje de error exacto.
Los pasos que ya has intentado.
Capturas de pantalla si es posible.
El nombre de tu dominio y, si lo sabes, el nombre de la base de datos.

[INFO] Si tu hosting usa Syspanel, menciona que estás gestionando tu sitio desde ahí. El soporte sabrá exactamente a qué te refieres. Recuerda que el acceso al panel es a través del puerto 2106.

Prevención: Cómo evitar este error en el futuro

Una vez que tu sitio esté de nuevo en línea, es buena idea tomar algunas medidas para evitar que esto vuelva a ocurrir.

Copias de seguridad regulares

Esta es la regla de oro. Asegúrate de tener copias de seguridad automáticas de tu base de datos y de tus archivos. La mayoría de los paneles de control ofrecen esta función. En Syspanel, busca la sección de "Copias de seguridad" o "Backups".

Mantén todo actualizado

Actualiza WordPress, tus plugins y tus temas con regularidad. Las actualizaciones suelen corregir errores y vulnerabilidades que pueden causar problemas de conexión.

Utiliza un plugin de caché

Un plugin de caché puede reducir la carga en tu base de datos y evitar que se sature, lo que puede prevenir errores de conexión.

Monitoriza el estado de tu sitio

Existen servicios gratuitos que te avisan por correo si tu sitio web se cae. Así podrás reaccionar rápidamente ante cualquier problema.

Preguntas frecuentes (FAQ)

¿Puedo perder mis datos si hago esto?

No, los pasos descritos en esta guía están diseñados para reparar la conexión, no para borrar datos. La única excepción sería si la base de datos está dañada a un nivel muy profundo, pero eso es raro.

¿Qué es exactamente `wp-config.php`?

Es el archivo de configuración principal de WordPress. Contiene la información crítica de tu sitio, incluyendo los datos de conexión a la base de datos, claves secretas y prefijos de tabla.

¿Por qué aparece este error después de mover mi sitio a otro hosting?

Es muy común. Al mover un sitio, los datos de la base de datos (nombre, usuario, contraseña, host) suelen cambiar. Debes actualizar el archivo wp-config.php con los nuevos datos.

¿El error puede ser un ataque de hackers?

Es posible, aunque no es lo más común. Un atacante podría modificar tu wp-config.php o corromper tu base de datos. Si sospechas de un ataque, cambia todas tus contraseñas (hosting, base de datos, WordPress) y contacta con tu proveedor.

¿Qué hago si nada de esto funciona?

Si has agotado todas las opciones, el problema es definitivamente del lado del servidor. Contacta con tu proveedor de hosting lo antes posible. Ellos tienen acceso a los logs del servidor y pueden diagnosticar el problema de raíz.

Conclusión

El error "Error al establecer conexión con la base de datos" puede ser frustrante, pero como has visto, la mayoría de las veces tiene una solución clara y sencilla. Siguiendo estos pasos de forma metódica, podrás diagnosticar y resolver el problema tú mismo en la mayoría de los casos.

Recuerda siempre empezar por lo más simple: verificar los datos en wp-config.php. Luego, continúa con las soluciones más avanzadas si es necesario. Y si te quedas atascado, no dudes en contactar con el soporte de tu hosting. Ellos están ahí para ayudarte.

Espero que esta guía te haya sido de gran ayuda. Ahora, ve y arregla ese sitio web. ¡Buena suerte!