Error de conexión a base de datos WordPress en Plesk: Solución

¡Hola! Soy el técnico de soporte. Entiendo que ver el mensaje "Error establishing a database connection" en tu WordPress puede ser desesperante, especialmente si tienes contenido importante o una tienda online funcionando. No te preocupes, es uno de los errores más comunes y, por suerte, casi siempre tiene solución.

Este error significa que WordPress no puede comunicarse con la base de datos donde se almacenan tus entradas, páginas, usuarios y configuraciones. En este artículo, te guiaré paso a paso para solucionar el error base de datos WordPress cuando usas Plesk como panel de control de hosting. Vamos a ir desde lo más básico hasta algo más técnico, pero siempre con un lenguaje claro.

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

Antes de lanzarnos a solucionarlo, es útil entender por qué ocurre. Las causas más frecuentes son:

Credenciales incorrectas: El archivo wp-config.php de WordPress tiene datos de acceso (usuario, contraseña, nombre de la base de datos) que no coinciden con los reales.
Base de datos corrupta: A veces, una tabla se daña y WordPress no puede leerla.
Servidor de base de datos caído o sobrecargado: El servicio MySQL/MariaDB (el motor de base de datos) puede haberse detenido o estar saturado.
Problemas de permisos: El usuario de la base de datos no tiene los permisos adecuados para acceder a ella.
Cambios en el hosting: Una migración, una restauración o un cambio de servidor pueden desconfigurar los datos de conexión.

Vamos a atacar cada una de estas causas. Sigue los pasos en orden, ya que van de lo más sencillo a lo más complejo.

Paso 1: Verifica que el servicio de base de datos esté funcionando en Plesk

Lo primero es asegurarnos de que el motor de base de datos (MySQL o MariaDB) esté activo. Si está apagado, ningún sitio funcionará.

Para usuarios de Plesk (panel de control estándar):

Accede a tu panel de Plesk (normalmente en https://tudominio.com:8443 o la URL que te haya dado tu proveedor).
Ve a Herramientas y configuraciones (en el menú de la izquierda o en la parte inferior).
Busca la sección Servicios y haz clic en Administración de servicios.
Localiza el servicio MySQL o MariaDB. Debería aparecer como "En ejecución" (con un círculo verde).
Si está apagado, selecciona la casilla y haz clic en el botón Iniciar.

[WARNING] Si no ves la opción de administración de servicios, es posible que no tengas permisos de administrador del servidor. En ese caso, contacta a tu proveedor de hosting y pídeles que verifiquen que el servicio MySQL esté corriendo.

Paso 2: Revisa y corrige las credenciales en `wp-config.php`

Este es el paso más común. El error suele deberse a que las credenciales guardadas en WordPress no coinciden con las reales.

¿Cómo acceder al archivo `wp-config.php` en Plesk?

En tu panel de Plesk, ve a Sitios web y dominios.
Haz clic en Administrador de archivos (el icono de la carpeta).
Navega hasta la carpeta donde está instalado WordPress (normalmente httpdocs o public_html).
Busca el archivo wp-config.php y haz clic derecho sobre él. Selecciona Editar en el editor de texto.

¿Qué buscar y cómo corregirlo?

Dentro del archivo, busca las siguientes líneas (normalmente al principio):

define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'usuario_de_la_bd');
define('DB_PASSWORD', 'contraseña_de_la_bd');
define('DB_HOST', 'localhost');

Ahora, necesitas verificar estos datos. Para ello:

Ve a Sitios web y dominios > Bases de datos en Plesk.
Localiza la base de datos de tu WordPress. Verás el nombre de la base de datos y el nombre del usuario asociado.
Si no recuerdas la contraseña, haz clic en el nombre de la base de datos y luego en Cambiar contraseña (en la pestaña Usuarios). Establece una nueva y guárdala.
Ahora, en el editor de wp-config.php, actualiza las tres primeras líneas con los valores correctos. La línea DB_HOST suele ser localhost, pero si tu hosting usa un servidor remoto, te lo habrán indicado.

[TIP] Si cambias la contraseña en Plesk, asegúrate de actualizarla también en wp-config.php. Un error muy común es cambiar la contraseña en el panel y olvidarse de actualizarla en el archivo.

Guarda los cambios en el archivo y cierra el editor.

Vuelve a cargar tu web. Si el error persiste, continúa con el siguiente paso.

Paso 3: Repara la base de datos desde Plesk (si está corrupta)

A veces, una tabla se daña y WordPress no puede leerla. Plesk tiene una herramienta para reparar bases de datos.

Ve a Sitios web y dominios > Bases de datos.
Haz clic en el nombre de la base de datos de tu WordPress.
En la página de administración de la base de datos, busca el botón Reparar o Repair.
Confirma la acción. Plesk ejecutará automáticamente una reparación de todas las tablas.

[INFO] Si no ves la opción "Reparar", también puedes hacerlo manualmente desde phpMyAdmin (accesible desde el mismo panel de Plesk). Una vez dentro, selecciona la base de datos, marca todas las tablas, y en el menú desplegable elige "Reparar tabla".

Paso 4: Verifica los permisos del usuario de la base de datos

Si el usuario no tiene todos los permisos necesarios (SELECT, INSERT, UPDATE, DELETE, etc.), WordPress no podrá funcionar.

En Bases de datos de Plesk, haz clic en el nombre de tu base de datos.
Ve a la pestaña Usuarios.
Haz clic en el nombre del usuario (o en el icono de editar).
Asegúrate de que tenga marcados todos los privilegios (o al menos los básicos: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP).
Guarda los cambios.

Paso 5: Comprueba el archivo `wp-config.php` en busca de espacios o caracteres extraños

A veces, al editar el archivo, se pueden introducir espacios en blanco o caracteres invisibles antes de <?php o después de ?>. Esto puede romper la conexión.

Abre el archivo wp-config.php en el editor de Plesk.
Muy importante: Asegúrate de que NO haya nada antes de la línea <?php (ni espacios, ni líneas en blanco).
Al final del archivo, después de la línea require_once(ABSPATH . 'wp-settings.php');, no debería haber nada más que un salto de línea. Si ves algo, bórralo.
Guarda y prueba.

Paso 6: Reinicia el servicio MySQL desde la terminal (si tienes acceso SSH)

Si has llegado hasta aquí y el error persiste, es posible que el servicio esté colgado o necesite un reinicio forzado. Esto requiere acceso SSH al servidor.

Conéctate a tu servidor vía SSH (con un programa como PuTTY o desde la terminal).
Ejecuta el siguiente comando (dependiendo de tu sistema operativo del servidor):
- Para sistemas con systemd (Ubuntu 16.04+, CentOS 7+): sudo systemctl restart mysql o sudo systemctl restart mariadb
- Para sistemas con SysV init (más antiguos): sudo service mysql restart o sudo /etc/init.d/mysql restart

[WARNING] Si no tienes acceso SSH o no te sientes cómodo con la terminal, contacta a tu proveedor de hosting y pídeles que reinicien el servicio MySQL. Es una petición común y rápida.

Paso 7: Restaura una copia de seguridad reciente

Si nada de lo anterior funciona, es posible que la base de datos esté gravemente dañada o que un plugin o tema haya causado un conflicto. La solución más rápida es restaurar una copia de seguridad.

¿Cómo restaurar en Plesk?

Ve a Sitios web y dominios > Copias de seguridad.
Busca una copia de seguridad de la fecha anterior al error.
Selecciona la opción Restaurar.
Elige Restaurar archivos y bases de datos (o solo la base de datos si prefieres mantener los archivos actualizados).
Confirma la restauración.

[INFO] Si no tienes una copia de seguridad, puedes intentar exportar la base de datos desde phpMyAdmin (en Plesk), descargarla a tu PC, y luego importarla de nuevo. A veces esto repara tablas corruptas.

Preguntas Frecuentes (FAQ) sobre el error de conexión a la base de datos

¿El error puede deberse a un plugin o tema?

Sí, aunque es menos común. Un plugin o tema mal codificado puede saturar la base de datos o modificar el archivo wp-config.php. Para descartarlo, desactiva temporalmente todos los plugins renombrando la carpeta wp-content/plugins a wp-content/plugins_old desde el Administrador de archivos de Plesk. Si el error desaparece, reactiva uno por uno para encontrar el culpable.

¿Qué hago si veo el error en todo el sitio excepto en el panel de administración?

Si puedes acceder a /wp-admin, ve a Ajustes > Enlaces permanentes y haz clic en Guardar cambios sin modificar nada. Esto regenera las reglas de reescritura y puede solucionar problemas de conexión.

¿El servidor de base de datos tiene límite de conexiones?

Sí. Si tu sitio recibe mucho tráfico, el servidor puede alcanzar el límite de conexiones simultáneas. Pide a tu hosting que aumente el límite (max_connections) o considera cambiar a un plan superior.

¿Y si uso Syspanel (HestiaCP) en lugar de Plesk?

Si tu panel es Syspanel (HestiaCP), el proceso es muy similar. Accede a Syspanel a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Luego, ve a Base de datos y sigue los mismos pasos: verifica credenciales, repara la base de datos desde la opción correspondiente, y reinicia el servicio MySQL desde Servicios.

Resumen rápido: Checklist para solucionar el error

Si quieres ir directo al grano, sigue esta lista de verificación:

¿El servicio MySQL/MariaDB está corriendo en Plesk? (Paso 1)
¿Las credenciales en wp-config.php son correctas? (Paso 2)
¿La base de datos está reparada? (Paso 3)
¿El usuario tiene todos los permisos? (Paso 4)
¿El archivo wp-config.php no tiene espacios extraños? (Paso 5)
¿Has reiniciado el servicio MySQL? (Paso 6)
¿Has restaurado una copia de seguridad? (Paso 7)

[TIP] Si después de todo esto el error persiste, el problema probablemente sea del servidor (hardware, configuración de red, etc.). En ese caso, contacta a tu proveedor de hosting y diles que has seguido todos los pasos de solución de errores de conexión a la base de datos. Ellos podrán revisar los logs del servidor y darte una respuesta más precisa.

Espero que este artículo te haya ayudado a solucionar el error base de datos WordPress y que tu sitio vuelva a funcionar. Recuerda que la paciencia es clave y que, como técnico de soporte, siempre estoy aquí para guiarte. ¡Buena suerte!