Solucionar 'Error al conectar con la base de datos' en WordPress (cPanel/Plesk)

¿Qué significa exactamente este error?

Cuando visitas tu sitio web y en lugar de tu página aparece el mensaje "Error al conectar con la base de datos", significa que WordPress no ha podido comunicarse con el servidor donde se almacenan tus contenidos, usuarios, comentarios y ajustes.

Este es uno de los errores más comunes en WordPress y, aunque asusta al principio, en la mayoría de los casos tiene solución en pocos minutos. El mensaje puede aparecer de varias formas: como un texto plano, dentro de un recuadro blanco, o incluso acompañado de avisos como "Error establishing a database connection" si tu instalación está en inglés.

Para entenderlo fácilmente: imagina que tu web es una tienda. La base de datos es el almacén donde guardas todos los productos. Si la puerta del almacén está cerrada, rota o la llave no coincide, no podrás vender nada. Pues exactamente eso es lo que ocurre aquí.

A lo largo de esta guía te explicaré, paso a paso, cómo corregir el error base de datos WordPress tanto si usas cPanel como si usas Plesk. No necesitas ser un experto, solo seguir el orden que te propongo. Vamos a ello.

Antes de empezar: haz una copia de seguridad

[WARNING] Antes de tocar cualquier archivo o configuración, haz una copia de seguridad completa de tu sitio. Aunque los pasos que te explico son seguros, es mejor prevenir. Puedes hacerla desde el panel de tu hosting, con un plugin como UpdraftPlus, o descargando los archivos por FTP y exportando la base de datos desde phpMyAdmin.

Paso 1: Verifica los datos de conexión en wp-config.php

El primer lugar donde debes mirar es el archivo wp-config.php, que se encuentra en la raíz de tu instalación de WordPress. Este archivo contiene las credenciales que WordPress usa para conectarse a la base de datos.

¿Cómo acceder al archivo?

Puedes acceder de dos formas:

Desde el administrador de archivos de cPanel o Plesk.
Mediante FTP con programas como FileZilla.

Una vez lo tengas localizado, ábrelo con un editor de texto (el bloc de notas vale) y busca estas líneas:

define( 'DB_NAME', 'tu_base_de_datos' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

¿Qué debo comprobar?

DB_NAME: Debe coincidir exactamente con el nombre de tu base de datos.
DB_USER: Debe ser el usuario asignado a esa base de datos.
DB_PASSWORD: Debe ser la contraseña correcta. Ojo con mayúsculas, minúsculas y símbolos.
DB_HOST: Normalmente es localhost, pero algunos hostings usan direcciones como mysql.tudominio.com o 127.0.0.1.

[TIP] Si no recuerdas tus credenciales, búscalas en el correo de bienvenida de tu hosting o en la sección "Bases de datos MySQL" de cPanel o Plesk.

Paso 2: Comprueba que la base de datos existe y está activa

A veces el problema es más simple de lo que parece: la base de datos ha sido eliminada, está corrupta o simplemente no está activa.

En cPanel:

Entra en cPanel y busca la sección "Bases de datos MySQL".
Verás un listado con todas tus bases de datos. Comprueba que la que usa tu WordPress aparece en la lista.
Si no aparece, tendrás que crearla de nuevo. Pero ojo: si la creas vacía, perderás tus datos. En ese caso, restaura desde una copia de seguridad.

En Plesk:

Ve a "Sitios web y dominios" y busca el apartado "Bases de datos".
Verifica que tu base de datos aparece y que el estado es "Activa".
Si está bloqueada o inactiva, actívala desde el mismo panel.

Paso 3: Revisa si el servidor de base de datos está caído

A veces el problema no es tuyo, sino del servidor. Si tu hosting está teniendo problemas con MySQL, todas las webs que usan ese servidor de bases de datos fallarán.

[INFO] Para comprobarlo, puedes mirar si otras webs de tu mismo hosting funcionan. Si también fallan, el problema es del servidor. En ese caso, contacta con el soporte de tu hosting y espera a que lo solucionen.

También puedes probar a reiniciar el servicio MySQL desde cPanel o Plesk, si tu plan de hosting te lo permite. A veces un simple reinicio soluciona el error de conexión WordPress.

Paso 4: Comprueba los límites de conexiones

Si tu web tiene mucho tráfico o algún plugin está haciendo consultas excesivas, es posible que se alcance el límite de conexiones simultáneas a la base de datos.

Este error error base de datos WordPress suele aparecer con mensajes como "Too many connections".

¿Cómo solucionarlo?

Optimiza tu web: instala un plugin de caché como W3 Total Cache o WP Super Cache.
Desactiva plugins pesados que hagan muchas consultas.
Aumenta el límite de conexiones si tu plan de hosting lo permite. En cPanel, puedes hacerlo desde "Métricas de recursos" o contactando con soporte técnico.

Paso 5: Repara la base de datos con phpMyAdmin

Si sospechas que tu base de datos está corrupta, puedes reparar base de datos WordPress directamente desde phpMyAdmin. WordPress tiene una función integrada para esto, pero también puedes hacerlo manualmente.

Método automático (sin tocar código):

Añade esta línea a tu archivo wp-config.php, justo antes de la línea que dice /* ¡Eso es todo, deja de editar! */:

define( 'WP_ALLOW_REPAIR', true );

Guarda el archivo y visita esta URL:

https://tudominio.com/wp-admin/maint/repair.php

Verás dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Haz clic en la segunda para hacer ambas cosas.

[WARNING] Después de terminar, elimina esa línea de tu wp-config.php. Si la dejas, cualquiera podría acceder a esa página de reparación.

Método manual con phpMyAdmin:

Entra en phpMyAdmin desde cPanel o Plesk.
Selecciona tu base de datos en el panel izquierdo.
Marca todas las tablas con la casilla superior.
En el desplegable que dice "Con seleccionadas", elige "Reparar tabla".

Esto puede tardar unos segundos. Cuando termine, verás un mensaje de éxito o error por cada tabla.

Paso 6: Revisa los permisos del usuario de la base de datos

Otra causa común es que el usuario de la base de datos haya perdido permisos o no tenga los privilegios necesarios.

En cPanel:

Ve a "Bases de datos MySQL".
Busca la sección "Usuarios en la base de datos".
Asegúrate de que tu usuario está asignado a la base de datos correcta.
Si no está, añádelo y marca TODOS LOS PRIVILEGIOS.

En Plesk:

Ve a tu dominio y entra en "Bases de datos".
Selecciona tu base de datos y pulsa en "Usuarios".
Comprueba que el usuario tiene permisos completos sobre la base de datos.

Paso 7: Cambia la contraseña de la base de datos

Si nada de lo anterior funciona, puede que la contraseña se haya corrompido o contenga caracteres extraños. La solución es cambiarla.

En cPanel:

Ve a "Bases de datos MySQL".
En la sección de usuarios, busca tu usuario y pulsa "Cambiar contraseña".
Introduce una contraseña segura (con mayúsculas, números y símbolos).
Ahora actualiza la contraseña en tu archivo wp-config.php.

En Plesk:

Entra en tu dominio, ve a "Bases de datos" y selecciona tu base.
Pulsa en "Usuarios" y edita el usuario.
Cambia la contraseña y actualiza el archivo wp-config.php.

[TIP] Cuando cambies la contraseña, asegúrate de guardar el archivo wp-config.php antes de volver a cargar tu web.

Paso 8: Comprueba el archivo .htaccess

Aunque es menos habitual, un archivo .htaccess corrupto puede provocar el error de conexión. Para descartarlo:

Accede a la raíz de tu WordPress por FTP o administrador de archivos.
Renombra el archivo .htaccess a .htaccess.bak.
Recarga tu web.

Si funciona, ve a Ajustes > Enlaces permanentes en el panel de WordPress y pulsa "Guardar cambios" para regenerar el archivo.

Paso 9: Actualiza WordPress, plugins y temas

A veces el error es provocado por una incompatibilidad entre una versión antigua de WordPress y la versión de PHP o MySQL de tu servidor.

[INFO] Si no puedes acceder al panel de administración porque el error te lo impide, puedes actualizar WordPress manualmente descargando la última versión desde wordpress.org y reemplazando los archivos por FTP. No borres tu carpeta wp-content.

Paso 10: Contacta con tu proveedor de hosting

Si has seguido todos los pasos anteriores y el error base de datos WordPress persiste, es hora de contactar con el soporte técnico de tu hosting.

Dales toda la información posible:

El mensaje de error exacto.
Los pasos que ya has probado.
Tu dominio y si usas cPanel, Plesk o Syspanel (en caso de que tu hosting use este panel, recuerda que el acceso es a través del puerto 2106).

[WARNING] No intentes tocar archivos del sistema ni configuraciones avanzadas si no sabes lo que haces. Podrías empeorar el problema.

Preguntas frecuentes (FAQ)

¿El error "Error al conectar con la base de datos" significa que he perdido mi web?

No. En la gran mayoría de los casos, los datos siguen intactos en la base de datos. Es un problema de conexión, no de pérdida de información.

¿Puedo prevenir este error?

Sí, con estas buenas prácticas:

Haz copias de seguridad periódicas.
Mantén WordPress, plugins y temas actualizados.
Usa un hosting de calidad.
No instales plugins de fuentes desconocidas.

¿Cuánto tiempo puedo tardar en solucionarlo?

Si es un problema de credenciales, menos de 10 minutos. Si hay que reparar la base de datos, puede llevar entre 15 y 30 minutos. Si es un problema del servidor, dependerás del soporte de tu hosting.

¿Qué es eso de Syspanel que mencionas?

Syspanel es un panel de control de hosting alternativo a cPanel y Plesk. Si tu hosting lo utiliza, el acceso se realiza normalmente a través del puerto 2106. Los pasos para gestionar bases de datos son similares a los de Plesk, pero con nombres de secciones ligeramente distintos.

Resumen final

El error al conectar con la base de datos en WordPress es un problema común pero perfectamente solucionable. Siguiendo estos pasos en orden, casi siempre encontrarás la causa:

Revisa las credenciales en wp-config.php.
Comprueba que la base de datos existe y está activa.
Verifica que el servidor MySQL no esté caído.
Controla los límites de conexiones.
Repara la base de datos con phpMyAdmin.
Revisa los permisos del usuario.
Cambia la contraseña si es necesario.
Comprueba el .htaccess.
Actualiza WordPress.
Contacta con tu hosting si nada funciona.

[TIP] Si eres usuario de Syspanel, no olvides que el acceso es a través del puerto 2106. El resto de pasos son prácticamente idénticos a los de Plesk.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia y el orden son tus mejores aliados. Si tienes cualquier duda, déjala en los comentarios y estaré encantado de ayudarte. ¡Buena suerte con tu WordPress!