Errores de conexión a base de datos en WordPress con Plesk: soluciones

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver juntos uno de los problemas más frustrantes que puedes encontrar al gestionar tu sitio web: el temido error de conexión a la base de datos en WordPress cuando usas Plesk. No te preocupes, es más común de lo que crees y, por lo general, tiene una solución sencilla. Vamos a desglosarlo paso a paso, como si estuviéramos tomando un café y arreglando el mundo.

¿Por qué aparece el error de conexión a la base de datos?

Imagina que tu sitio web es una casa. WordPress es el mobiliario y el contenido (textos, fotos, plugins), pero la base de datos es el sótano donde guardas todos los planos, los nombres de los muebles y las instrucciones de montaje. Cuando ves el mensaje "Error establishing a database connection" (Error al establecer la conexión con la base de datos) o simplemente una página en blanco, significa que WordPress no puede encontrar la llave para abrir ese sótano. Las causas más habituales son:

Credenciales incorrectas: El nombre de usuario, la contraseña o el nombre de la base de datos no coinciden con los que tiene WordPress configurados.
Servidor de base de datos caído o sobrecargado: El motor MySQL o MariaDB no está funcionando o está muy ocupado.
Archivo wp-config.php dañado o mal configurado: Este archivo es el que guarda las llaves del sótano. Si está corrupto, no se puede abrir la puerta.
Permisos de usuario incorrectos: El usuario de la base de datos no tiene permisos para acceder a ella desde el servidor web.
Firewall o seguridad bloqueando la conexión: A veces, el cortafuegos de Plesk o del servidor impide la comunicación.

Vamos a solucionarlo. Sigue estos pasos en orden, como una receta de cocina. No te saltes ninguno.

Paso 1: Verificar el estado del servicio de base de datos en Plesk

Lo primero es asegurarnos de que el motor de base de datos (MySQL/MariaDB) esté encendido y funcionando. Plesk tiene una interfaz muy clara para esto.

Accede a Plesk (normalmente en https://tudominio.com:8443 o la URL que te haya dado tu proveedor).
Ve a Herramientas y Configuración (en el menú de la izquierda, abajo del todo).
Busca la sección Servicios y haz clic en Administración de Servicios.
Busca en la lista el servicio llamado MySQL o MariaDB. Debería tener un punto verde y decir "En ejecución".
Si ves un punto rojo o amarillo, haz clic en el icono de iniciar (un triángulo verde). Si no se inicia, puede que el servidor tenga un problema más grave. En ese caso, contacta con tu proveedor de hosting.

[TIP] Si el servicio se reinicia solo o se cae constantemente, puede que el servidor tenga poca memoria RAM. Pregunta a tu hosting si puedes aumentar los recursos.

Paso 2: Comprobar las credenciales en el archivo wp-config.php

Este es el paso más común y donde la mayoría de la gente encuentra la solución. El archivo wp-config.php está en la raíz de tu instalación de WordPress (normalmente en la carpeta httpdocs o public_html).

Conéctate a tu servidor mediante FTP (FileZilla, por ejemplo) o usa el Administrador de Archivos de Plesk (en el panel de tu dominio, ve a "Archivos").
Busca el archivo wp-config.php. Si no lo ves, asegúrate de que estás viendo archivos ocultos (en Plesk, suele haber un botón para mostrar archivos ocultos).
Ábrelo con un editor de texto (Bloc de Notas, Sublime Text, o el editor integrado de Plesk).
Busca las siguientes líneas. Deben verse así:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_la_base');
define('DB_PASSWORD', 'contraseña_segura');
define('DB_HOST', 'localhost');

¿Qué debes comprobar aquí?

DB_NAME: Debe coincidir exactamente con el nombre de la base de datos que creaste en Plesk (normalmente tiene un prefijo como tudominio_wpdb).
DB_USER: El nombre de usuario de la base de datos. A menudo es el mismo que el nombre de la base, pero con un sufijo _user.
DB_PASSWORD: La contraseña que pusiste al crear el usuario. ¡Cuidado con espacios al principio o al final!
DB_HOST: Casi siempre es localhost. Sin embargo, algunos hosts usan direcciones como 127.0.0.1 o un nombre de servidor específico (ej: mysql.tudominio.com). Si tu hosting te dio un host diferente, escríbelo exactamente.

¿Cómo obtener las credenciales correctas desde Plesk?

En Plesk, ve a tu dominio y haz clic en Bases de Datos.
Verás una lista de bases de datos. Haz clic en el nombre de la que usa tu WordPress.
Allí verás el nombre de la base de datos, el usuario y un enlace para cambiar la contraseña. Si no recuerdas la contraseña, cámbiala por una nueva y luego actualízala en el archivo wp-config.php.

[WARNING] No uses caracteres especiales como ', " o \ en la contraseña, ya que pueden romper el archivo PHP. Usa letras, números y símbolos como !@#$%.

Paso 3: Verificar los permisos del usuario de la base de datos

A veces el usuario tiene la contraseña correcta, pero no tiene permisos para acceder desde el servidor web. En Plesk esto se gestiona automáticamente, pero podemos verificarlo.

En Plesk, ve a Bases de Datos y haz clic en el nombre de tu base de datos.
Busca la sección Usuarios (o Usuarios de base de datos).
Asegúrate de que el usuario que usa WordPress esté marcado con todos los privilegios (normalmente se concede automáticamente). Si no, edítalo y marca "ALL PRIVILEGES" (Todos los privilegios).
Guarda los cambios.

Paso 4: Probar la conexión manualmente (para usuarios avanzados)

Si los pasos anteriores no funcionan, podemos hacer una prueba directa para ver si el problema es de WordPress o de la base de datos en sí.

Crea un archivo nuevo llamado testdb.php en la raíz de tu sitio (junto al wp-config.php).
Pega este código:

<?php
$link = mysqli_connect('localhost', 'tu_usuario', 'tu_contraseña', 'tu_base_de_datos');
if (!$link) {
    die('Error de conexión: ' . mysqli_connect_error());
}
echo '¡Conectado correctamente!';
mysqli_close($link);
?>

Recuerda reemplazar:

'tu_usuario' por el nombre de usuario de tu base de datos.
'tu_contraseña' por la contraseña.
'tu_base_de_datos' por el nombre de la base de datos.

Guarda el archivo.
Accede a tudominio.com/testdb.php en tu navegador.

Si ves "¡Conectado correctamente!": La base de datos funciona bien. El problema está en el archivo wp-config.php o en otro plugin de WordPress.
Si ves un error (ej: "Access denied for user"): Las credenciales son incorrectas o el usuario no tiene permisos. Vuelve al Paso 2 y 3.
Si ves "Can't connect to MySQL server": El servicio de base de datos no está corriendo (vuelve al Paso 1) o el DB_HOST es incorrecto.

[INFO] Después de la prueba, borra el archivo testdb.php por seguridad. No dejes archivos de prueba en tu servidor.

Paso 5: Reparar la base de datos de WordPress

A veces la base de datos está dañada (por ejemplo, tras una actualización fallida o un corte de luz). WordPress tiene una herramienta de reparación integrada.

Añade la siguiente línea al archivo wp-config.php, justo antes de la línea que dice /* That's all, stop editing! Happy blogging. */:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Accede a tudominio.com/wp-admin/maint/repair.php.
Verás dos opciones: "Repair Database" (Reparar base de datos) y "Repair and Optimize Database" (Reparar y optimizar). Empieza con la primera.
Cuando termine, vuelve a tu wp-config.php y elimina esa línea (la de WP_ALLOW_REPAIR). Si la dejas, cualquiera podría acceder a esa URL y dañar tu base de datos.

[WARNING] No dejes la línea define('WP_ALLOW_REPAIR', true); activa permanentemente. Es una puerta abierta a posibles ataques.

Paso 6: Revisar el firewall y la seguridad de Plesk

Plesk incluye un firewall (gestor de reglas) que puede bloquear conexiones a la base de datos si está mal configurado.

En Plesk, ve a Herramientas y Configuración > Firewall (o Seguridad del servidor > Firewall).
Asegúrate de que el puerto 3306 (puerto por defecto de MySQL) esté permitido para conexiones locales (desde el mismo servidor). Normalmente, en un hosting compartido, la base de datos solo debe ser accesible desde localhost, no desde Internet. Si ves una regla que bloquea el tráfico local, desactívala.
Si usas algún plugin de seguridad en WordPress (como Wordfence, Sucuri, etc.), desactívalo temporalmente renombrando la carpeta del plugin desde FTP (por ejemplo, cambia wp-content/plugins/wordfence a wp-content/plugins/wordfence_desactivado). Luego prueba de nuevo.

Paso 7: Soluciones rápidas para errores específicos

Aquí tienes algunos errores concretos y su solución express:

Error: "Too many connections"

Causa: Muchos usuarios o procesos están usando la base de datos a la vez.
Solución: Pide a tu hosting que aumente el límite de conexiones (max_connections). También puedes desactivar plugins que hagan muchas consultas (como estadísticas en tiempo real). Temporalmente, reinicia el servicio MySQL desde Plesk (Paso 1) para liberar conexiones.

Error: "Table 'wp_options' is marked as crashed"

Causa: Una tabla de la base de datos está dañada.
Solución: Usa la herramienta de reparación del Paso 5. También puedes hacerlo desde phpMyAdmin (accesible desde Plesk > Bases de Datos > haz clic en el nombre de la base > phpMyAdmin). Selecciona la tabla dañada y elige "Reparar tabla" en el menú inferior.

Error: "Can't connect to local MySQL server through socket"

Causa: El archivo socket de MySQL no se encuentra o la ruta es incorrecta.
Solución: Cambia el DB_HOST de localhost a 127.0.0.1 en el wp-config.php. Si eso no funciona, contacta a tu hosting, ya que es un problema de configuración del servidor.

Preguntas Frecuentes (FAQ)

P: ¿Pierdo mis datos si reparo la base de datos?
R: No, la reparación solo corrige índices y tablas dañadas. No borra contenido. Pero siempre es buena práctica hacer una copia de seguridad antes (en Plesk puedes hacerlo en la sección "Bases de Datos" > "Exportar dump").

P: ¿Puedo cambiar la contraseña de la base de datos desde Plesk sin romper mi web?
R: Sí, pero debes actualizar también el archivo wp-config.php con la nueva contraseña. Si no lo haces, tu web dejará de funcionar.

P: Mi web funciona, pero de repente da el error. ¿Es un ataque?
R: Puede ser un ataque de fuerza bruta, pero también un plugin malicioso o una actualización fallida. Revisa los registros de Plesk (en "Herramientas y Configuración" > "Registros") o los logs de WordPress (instala un plugin como "WP Debugging" para ver errores).

P: ¿Qué hago si nada funciona?
R: No te desesperes. Contacta con el soporte técnico de tu hosting. Diles que has seguido estos pasos: has verificado el servicio MySQL, las credenciales en wp-config.php, los permisos del usuario y has probado con un script de prueba. Esto les ahorrará tiempo y te ayudarán más rápido.

Conclusión: Tú puedes con esto

El error de conexión a la base de datos en WordPress con Plesk suele ser un problema de configuración, no algo catastrófico. Siguiendo estos pasos en orden, lo más probable es que lo resuelvas en menos de 15 minutos. Recuerda:

Siempre haz copias de seguridad antes de tocar archivos importantes.
No uses contraseñas débiles (usa el generador de contraseñas de Plesk).
Mantén WordPress, temas y plugins actualizados para evitar corrupción de base de datos.

Si en algún momento te sientes perdido, respira hondo y vuelve al Paso 1. Estoy seguro de que lo lograrás. ¡Ánimo y a seguir construyendo tu web!