Guía para resolver el error de conexión a base de datos en WordPress con Plesk
¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto es porque seguramente has visto la temida pantalla blanca o el mensaje "Error al establecer una conexión a la base de datos" en tu WordPress alojado en Plesk. No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución.
En esta guía extensa y muy visual, vamos a desglosar paso a paso cómo diagnosticar y reparar WordPress Plesk cuando falla la conexión. Aprenderás desde lo más básico (¿qué es una base de datos?) hasta técnicas avanzadas como editar archivos de configuración o usar herramientas de Plesk. Todo explicado en un lenguaje sencillo, sin tecnicismos de más.
Vamos allá.
¿Qué significa exactamente "error de conexión a base de datos"?
Imagina que tu web WordPress es una tienda. La base de datos es el almacén donde guardas todos los productos (artículos), los precios (configuraciones) y los datos de tus clientes (usuarios). Cuando alguien visita tu web, WordPress necesita "abrir la puerta del almacén" para mostrar la información.
El error de conexión significa que WordPress no puede encontrar la llave correcta (los datos de acceso) o que el almacén (el servidor de base de datos) está cerrado o no responde. Esto puede pasar por tres razones principales:
- Credenciales incorrectas: El usuario, la contraseña, el nombre de la base de datos o el servidor (host) están mal escritos en el archivo de configuración de WordPress (
wp-config.php). - Problemas en el servidor de base de datos: El servicio MySQL/MariaDB se ha detenido, está sobrecargado o tiene un error.
- Corrupción de la base de datos: Los datos internos se han dañado, impidiendo que WordPress los lea correctamente.
En Plesk, además, hay herramientas específicas que nos facilitan mucho la vida. Vamos a ver cómo usarlas.
Diagnóstico inicial: ¿Por dónde empiezo?
Antes de tocar nada, vamos a hacer un pequeño chequeo para saber si el problema es tuyo (de la configuración) o del servidor.
### Paso 1: Prueba con otro navegador o desde el móvil
A veces la caché del navegador nos engaña. Abre la web en una ventana de incógnito o desde tu teléfono (conectado a datos móviles, no al WiFi de tu casa). Si se ve bien, el problema es la caché local. Si sigue sin cargar, continúa.
### Paso 2: Revisa el estado de Plesk
Accede a tu panel de Plesk (normalmente https://tudominio.com:8443 o la IP de tu servidor seguida de :8443). Una vez dentro, fíjate en la esquina superior derecha o en el panel de inicio. Deberías ver un indicador verde que dice "Todo correcto" o similar. Si ves algún aviso en rojo sobre "Servicios", "MySQL" o "Base de datos", el problema está en el servidor.
[WARNING] Si ves que el servicio MySQL aparece como "Detenido" o "Inactivo", no intentes arreglar nada más. Contacta con tu proveedor de hosting o, si tienes acceso a la terminal, ejecuta (con cuidado) el comando para reiniciar el servicio. En Plesk, a veces puedes reiniciarlo desde "Herramientas y Configuración" > "Gestor de Servicios".
### Paso 3: ¿Afecta a todo el sitio o solo a una página?
Si el error aparece en toda la web (incluyendo el panel de administración /wp-admin), es un problema general. Si solo falla una página concreta, puede ser un plugin o tema conflictivo que está haciendo una consulta incorrecta. Para este último caso, la solución suele ser desactivar plugins por FTP (lo veremos más adelante).
Solución 1: Verificar y corregir las credenciales en wp-config.php
Esta es la causa más frecuente del error base datos WordPress Plesk. Cuando cambias de hosting, restauras una copia de seguridad o modificas algo en Plesk, las credenciales pueden desincronizarse.
### ¿Dónde está el archivo wp-config.php?
Está en la raíz de tu sitio web, dentro de la carpeta httpdocs (o public_html). Puedes acceder a él de dos formas:
- A través del Administrador de archivos de Plesk: Ve a "Sitios web y dominios", busca tu dominio, haz clic en "Administrador de archivos". Navega hasta la carpeta
httpdocsy busca el archivowp-config.php. - A través de FTP: Conéctate con un cliente FTP (como FileZilla) y busca el mismo archivo.
### ¿Qué debo buscar dentro?
Abre el archivo wp-config.php con un editor de texto (el bloc de notas de Plesk vale, pero mejor usar uno como Notepad++). Busca las líneas que empiezan así:
define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'usuario_de_tu_bd');
define('DB_PASSWORD', 'contraseña_de_tu_bd');
define('DB_HOST', 'localhost');
Estos son los cuatro datos mágicos. Ahora, ve a Plesk y compáralos.
### Cómo obtener las credenciales correctas desde Plesk
- En Plesk, ve a "Sitios web y dominios".
- Busca tu dominio y haz clic en "Bases de datos".
- Verás una lista de bases de datos asociadas a tu sitio. Haz clic en el nombre de la base de datos de tu WordPress.
- En la nueva ventana, verás:
- Nombre de la base de datos: (DB_NAME)
- Nombre de usuario de la base de datos: (DB_USER)
- Host: Normalmente es
localhost, pero a veces puede ser una IP o un nombre comolocalhost:/tmp/mysql5.sock. Copia exactamente lo que pone. - Contraseña: No la verás directamente, pero hay un botón "Cambiar contraseña" o "Mostrar contraseña". Si no la recuerdas, cámbiala por una nueva.
[TIP] Si cambias la contraseña en Plesk, asegúrate de actualizarla también en
wp-config.php. Es un paso que se olvida a menudo.
### Edita el archivo y guarda
Reemplaza los valores de DB_NAME, DB_USER, DB_PASSWORD y DB_HOST con los que acabas de obtener de Plesk. Guarda el archivo y vuelve a cargar tu web.
Si el error persiste, pasa a la siguiente solución.
Solución 2: Reparar la base de datos desde Plesk (sin saber SQL)
A veces la base de datos no está caída, sino que tiene pequeños daños internos (tablas corruptas). Plesk incluye una herramienta para repararlas automáticamente.
### Pasos para la reparación:
- Ve a "Sitios web y dominios" > "Bases de datos".
- Haz clic en el nombre de la base de datos de tu WordPress.
- En la parte superior, verás un botón o enlace que dice "Reparar" o "Comprobar y reparar". En versiones recientes de Plesk, puede estar dentro de "Herramientas".
- Pulsa el botón. El sistema ejecutará un comando
REPAIR TABLEsobre todas las tablas. Esto puede tardar unos segundos. - Cuando termine, te mostrará un mensaje de éxito o te dirá si hubo algún error grave.
[INFO] Esta herramienta es segura. No borra datos, solo intenta arreglar índices y estructuras dañadas. Si el problema es más grave, te recomendará restaurar una copia de seguridad.
Solución 3: Forzar la reparación desde WordPress (método manual)
Si no puedes acceder a Plesk o la herramienta de reparación no funciona, puedes forzar a WordPress a que intente reparar la base de datos él mismo. Esto se hace añadiendo una línea mágica en wp-config.php.
### Pasos:
- Abre
wp-config.php(como hicimos antes). - Justo antes de la línea que dice
/* That's all, stop editing! Happy blogging. */, añade esta línea:
define('WP_ALLOW_REPAIR', true);
- Guarda el archivo.
- Ahora, en tu navegador, visita esta URL (reemplaza
tudominio.compor tu dominio real):
https://tudominio.com/wp-admin/maint/repair.php
- Verás una pantalla con dos botones:
- Reparar base de datos: Solo repara.
- Reparar y optimizar base de datos: Además de reparar, reorganiza los datos para que la web vaya más rápida. Recomiendo usar esta opción.
- Haz clic en el que prefieras. El proceso puede tardar unos minutos. Verás una lista de tablas y su estado.
- IMPORTANTE: Cuando termines, vuelve a
wp-config.phpy ELIMINA la línea que añadiste. Si no la borras, cualquier persona podría ejecutar esta herramienta y dañar tu web. Es un riesgo de seguridad.
[WARNING] No olvides borrar la línea
define('WP_ALLOW_REPAIR', true);después de usarla. Es un agujero de seguridad enorme.
Solución 4: Comprobar el estado del servidor MySQL en Plesk
Si nada de lo anterior funciona, el problema puede ser que el servicio de base de datos esté caído. En Plesk, puedes verificarlo y reiniciarlo.
### Pasos para reiniciar MySQL desde Plesk:
- Ve a "Herramientas y Configuración" (en el menú de la izquierda).
- Busca la sección "Servicios" o "Gestor de Servicios".
- Localiza el servicio llamado MySQL o MariaDB.
- Verás su estado actual. Si está "Detenido", haz clic en el botón "Iniciar" o "Reiniciar".
- Espera unos segundos y vuelve a cargar tu web.
[TIP] Si el servicio se detiene a menudo, puede ser un problema de memoria del servidor. Contacta con tu hosting para que revisen los logs.
Solución 5: Restaurar una copia de seguridad (el plan B)
Si has llegado hasta aquí y el error persiste, es posible que la base de datos esté tan dañada que solo una restauración la salve. Plesk facilita mucho este proceso.
### Pasos para restaurar desde una copia de seguridad de Plesk:
- Ve a "Sitios web y dominios" > "Copias de seguridad" (o "Administrador de copias de seguridad").
- Busca la copia de seguridad más reciente que tengas (idealmente de antes de que apareciera el error).
- Haz clic en "Restaurar".
- Selecciona solo la base de datos. No marques "Archivos del sitio" a menos que quieras perder cambios recientes en tus plantillas o plugins. La opción de restaurar solo la base de datos es muy segura.
- Confirma la restauración. Cuando termine, prueba tu web.
[INFO] Si no tienes copia de seguridad, este es un buen momento para configurarlas. En Plesk puedes programar copias diarias automáticas. Es gratis y te salvará la vida.
Preguntas Frecuentes (FAQ)
### ¿Por qué aparece el error después de mover mi web a un nuevo hosting?
Al migrar, las credenciales de la base de datos suelen cambiar. Es el caso más clásico. Solo tienes que actualizar wp-config.php con los nuevos datos que te da Plesk en el nuevo servidor.
### ¿Puedo usar un plugin para arreglar la conexión?
No directamente, porque si la base de datos no funciona, el plugin tampoco se cargará. Los plugins de reparación (como "WP-DBManager") funcionan solo cuando la conexión ya está establecida. Úsalos para mantenimiento preventivo, no para emergencias.
### ¿Qué hago si no encuentro wp-config.php en el Administrador de archivos?
Asegúrate de estar en la carpeta correcta (httpdocs). Si no está, puede que tu WordPress esté en una subcarpeta (ej: httpdocs/blog). También puede estar oculto. En Plesk, activa "Mostrar archivos ocultos" en la configuración del administrador de archivos.
### ¿El error "Error de conexión a base de datos" puede ser por un ataque?
Sí, aunque es menos común. Un ataque de fuerza bruta o un malware puede saturar la base de datos o cambiar las credenciales. Si sospechas de esto, cambia todas las contraseñas (de FTP, de la base de datos, de WordPress) y revisa los usuarios en Plesk.
### ¿Cómo accedo a phpMyAdmin desde Plesk para revisar manualmente?
En Plesk, ve a "Sitios web y dominios" > "Bases de datos". Haz clic en el nombre de la base de datos y luego en "phpMyAdmin". Allí podrás ejecutar consultas SQL manualmente, pero te recomiendo solo hacerlo si sabes lo que haces. La herramienta de reparación de Plesk es más segura.
Resumen final y consejos de prevención
Hemos visto cinco soluciones sólidas para el error base datos WordPress Plesk. Recuerda el orden lógico:
- Revisa credenciales (lo más común).
- Usa la herramienta de reparación de Plesk (rápido y seguro).
- Fuerza la reparación desde WordPress (si lo anterior falla).
- Reinicia el servicio MySQL (si el servidor está caído).
- Restaura una copia de seguridad (plan de emergencia).
Para evitar futuros sustos, te recomiendo:
- Programa copias de seguridad automáticas en Plesk (diarias o semanales).
- Actualiza WordPress, temas y plugins regularmente. Las versiones antiguas son más propensas a errores de base de datos.
- No uses contraseñas débiles para la base de datos. En Plesk, genera una contraseña segura automáticamente.
- Si usas Syspanel (HestiaCP), recuerda que el acceso es por el puerto 2106 y los pasos son muy similares: busca la sección de bases de datos, verifica credenciales y usa la herramienta de reparación integrada.
Y si después de todo esto el problema sigue, no dudes en contactar con el soporte de tu hosting. Diles que ya has probado estas soluciones; así se ahorrarán tiempo y te ayudarán más rápido.
¡Espero que tu web vuelva a la vida! Un saludo y buena suerte.
