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

¿Tu web en WordPress muestra el temido mensaje de «Error al establecer la conexión a la base de datos»? No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. Si estás usando Plesk como panel de control de tu hosting, este artículo es para ti. Te guiaremos paso a paso para identificar y reparar el error conexión base datos WordPress Plesk, incluso si no eres un experto técnico. Vamos a ello.

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

El mensaje «Error al establecer la conexión a la base de datos» aparece cuando WordPress intenta comunicarse con MySQL (el sistema que gestiona tu base de datos) pero no lo logra. Piensa en la base de datos como el archivo central de tu web: ahí se guardan tus entradas, páginas, usuarios y configuraciones. Si WordPress no puede «hablar» con ella, tu web se queda en blanco.

Las causas más frecuentes en un entorno Plesk son:

Credenciales incorrectas en el archivo wp-config.php: El nombre de la base de datos, el usuario o la contraseña no coinciden con los reales.
La base de datos o el usuario han sido eliminados o modificados: Algo que puede pasar al migrar o al limpiar cuentas viejas.
El servidor MySQL está caído o sobrecargado: Problema temporal del hosting.
Problemas de permisos: El usuario de la base de datos no tiene acceso a ella.
Corrupción de la base de datos: Raro, pero posible.

[INFO] No entres en pánico. En la mayoría de los casos, el problema se soluciona en menos de 15 minutos revisando el archivo wp-config.php o reiniciando servicios desde Plesk.

Paso 1: Accede a Plesk y localiza tu sitio web

Lo primero es entrar a tu panel de control Plesk. Normalmente se accede a través de una URL como https://tudominio.com:8443 o https://ipdelservidor:8443. Si no recuerdas la dirección, pídele a tu proveedor de hosting que te la facilite.

Una vez dentro, busca la sección «Sitios web y dominios» o «Dominios». Ahí encontrarás listados todos tus sitios. Haz clic en el nombre del dominio que está dando el error WordPress Plesk database error.

Paso 2: Verifica el estado del servidor MySQL desde Plesk

Antes de tocar archivos, asegúrate de que el motor de bases de datos esté funcionando. Plesk suele tener una herramienta para gestionar servicios.

En el panel izquierdo de Plesk, busca la opción «Herramientas y configuraciones» (o «Tools & Settings»).
Dentro, busca la sección «Servicios» y haz clic en «Gestor de servicios» (Services Manager).
Localiza el servicio «MySQL» o «MariaDB» (es lo mismo a efectos prácticos). Debería mostrar un estado verde y decir «Ejecutándose».
Si está apagado o con un icono rojo, selecciónalo y haz clic en «Iniciar» o «Reiniciar».

[TIP] A veces, simplemente reiniciar MySQL resuelve el error de conexión. Es un paso rápido que merece la pena probar.

Si el servicio se inicia correctamente, vuelve a cargar tu web. Si el error persiste, continúa con el siguiente paso.

Paso 3: Revisa y corrige el archivo wp-config.php (la solución más común)

El archivo wp-config.php es el corazón de la configuración de WordPress. Contiene las credenciales de tu base de datos. Si están mal, la conexión falla. Aquí te explicamos cómo revisarlo desde Plesk.

3.1. Accede al administrador de archivos de Plesk

Ve a tu dominio en «Sitios web y dominios».
Busca el icono o el enlace que dice «Administrador de archivos» (File Manager). Suele tener un icono de una carpeta.
Se abrirá una ventana con la estructura de archivos de tu web. Entra en la carpeta httpdocs (a veces llamada public_html). Ahí dentro está tu instalación de WordPress.

3.2. Localiza y edita el archivo wp-config.php

Busca el archivo llamado wp-config.php. Si no lo ves, asegúrate de que la opción «Mostrar archivos ocultos» esté activada en el administrador de archivos.
Haz clic derecho sobre el archivo y selecciona «Editar» o «Edit in Text Editor». Se abrirá un editor de texto simple.

3.3. Verifica las líneas de conexión a la base de datos

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

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_la_base_de_datos');
define('DB_PASSWORD', 'contraseña_del_usuario');
define('DB_HOST', 'localhost');

Estos son los cuatro datos críticos. Ahora necesitas saber si son correctos. Para ello, ve a la sección de bases de datos en Plesk.

3.4. Compara con los datos reales en Plesk

Vuelve al panel principal de tu dominio en Plesk.
Busca la sección «Bases de datos» (Databases). Ahí verás un listado de las bases de datos asociadas a tu sitio.
Anota el nombre exacto de la base de datos. También verás un enlace para «Añadir usuario» o «Usuarios». Haz clic para ver los usuarios existentes y sus permisos.
Compara:
- DB_NAME: Debe coincidir exactamente con el nombre de la base de datos en Plesk.
- DB_USER: Debe coincidir con un usuario que tenga acceso a esa base de datos.
- DB_PASSWORD: Debe ser la contraseña correcta de ese usuario. Si no la recuerdas, puedes crear una nueva contraseña desde Plesk (en la sección de usuarios de la base de datos) y actualizarla en el wp-config.php.
- DB_HOST: Casi siempre es localhost. Solo cambia si tu hosting usa servidores de bases de datos remotos (algo poco común en Plesk compartido).

[WARNING] Ten mucho cuidado al editar wp-config.php. No borres ni modifiques ninguna otra línea. Solo cambia los valores de las cuatro líneas mencionadas. Guarda los cambios después de editar.

Paso 4: Repara la conexión MySQL WordPress desde Plesk (si el problema persiste)

Si las credenciales son correctas pero el error conexión base datos WordPress Plesk sigue, el problema podría ser de permisos o de la base de datos misma.

4.1. Verifica los permisos del usuario en la base de datos

En la sección «Bases de datos» de tu dominio, haz clic en el nombre de la base de datos.
Busca la pestaña o sección «Usuarios».
Asegúrate de que el usuario que usas en wp-config.php aparezca en la lista y tenga marcados los permisos «ALL PRIVILEGES» (todos los privilegios). Si no, edita el usuario y asígnale todos los permisos.
Guarda los cambios.

4.2. Repara la base de datos usando phpMyAdmin

Plesk incluye phpMyAdmin, una herramienta para gestionar bases de datos. A veces, una tabla corrupta puede causar el error.

En la sección «Bases de datos», haz clic en el icono de phpMyAdmin (suele ser un icono de una base de datos con un rayo).
Se abrirá una nueva pestaña. En la columna de la izquierda, selecciona tu base de datos.
Verás una lista de tablas. Marca la casilla de la parte inferior para «Seleccionar todo».
En el menú desplegable «Con selección:», elige «Reparar tabla» (Repair table). phpMyAdmin intentará reparar cualquier tabla dañada.
Espera a que termine el proceso. Si todo va bien, verás un mensaje de éxito.

[INFO] Reparar la base de datos es como pasarle un «antivirus». No borra datos, solo intenta arreglar errores internos de las tablas.

Paso 5: Soluciones adicionales si nada de lo anterior funciona

Si has seguido todos los pasos y el error reparar conexión MySQL WordPress persiste, prueba estas opciones avanzadas:

5.1. Restaura una copia de seguridad reciente

Si tienes una copia de seguridad de tu web (desde Plesk o un plugin), restaurarla puede ser la solución más rápida, especialmente si el problema surgió después de un cambio.

5.2. Contacta con tu proveedor de hosting

El problema podría estar en el servidor (por ejemplo, el límite de conexiones a MySQL se ha alcanzado o hay un problema de red). Tu proveedor de hosting puede verificar los logs del servidor y solucionarlo.

5.3. Revisa los registros de errores de WordPress

Puedes activar el modo de depuración de WordPress para obtener más detalles. Añade estas líneas a tu wp-config.php (justo antes de la línea que dice /* That's all, stop editing! */):

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Esto creará un archivo debug.log en la carpeta wp-content. Puedes descargarlo desde el administrador de archivos de Plesk y buscar pistas sobre el error.

[WARNING] Una vez hayas solucionado el problema, elimina o comenta esas líneas (poniendo // al principio) para no ralentizar tu web ni exponer información sensible.

Preguntas frecuentes (FAQ) sobre el error de conexión a base de datos en Plesk

P: ¿Por qué aparece el error después de cambiar la contraseña de la base de datos en Plesk?
R: Porque el archivo wp-config.php sigue usando la contraseña antigua. Debes actualizar la línea define('DB_PASSWORD', ...) con la nueva contraseña.

P: ¿Puedo usar el mismo usuario y contraseña para varias bases de datos en Plesk?
R: Sí, pero no es recomendable por seguridad. Cada web debería tener su propio usuario y base de datos.

P: Si cambio el nombre de la base de datos en Plesk, ¿tengo que actualizar wp-config.php?
R: Sí, absolutamente. El nombre en DB_NAME debe coincidir exactamente con el nuevo nombre.

P: El error aparece de repente sin que yo haya tocado nada. ¿Qué hago?
R: Prueba primero reiniciar MySQL desde el Gestor de servicios de Plesk (Paso 2). Si no funciona, contacta a tu hosting, ya que puede ser un problema del servidor.

P: ¿Qué es el puerto 2106 y cómo se relaciona con esto?
R: El puerto 2106 es el puerto por defecto para acceder al panel de control Syspanel (antes conocido como HestiaCP). Si tu hosting usa Syspanel en lugar de Plesk, el proceso de solución es muy similar, pero accederías a través de https://tudominio.com:2106. En Plesk, el puerto habitual es el 8443.

[TIP] Si tu web sigue caída después de intentar todo, no te desesperes. Guarda esta guía y contacta al soporte de tu hosting con el mensaje exacto de error. Ellos tienen acceso a los logs del servidor y podrán ayudarte rápidamente.

Con estos pasos, deberías poder solucionar el error conexión base datos WordPress Plesk y tener tu web funcionando de nuevo. Recuerda: la calma y la revisión metódica son tus mejores aliadas. ¡Buena suerte!