Errores de conexión a base de datos en WordPress (Plesk): Soluciones

¿Qué significa exactamente el error de conexión a la base de datos?

Cuando tu WordPress muestra el temido mensaje "Error al conectar con la base de datos", no significa que hayas perdido tu sitio web. Significa que WordPress, el programa que gestiona tu web, no puede hablar con la base de datos, que es el almacén donde se guardan tus artículos, páginas, comentarios y configuraciones.

Piensa en ello como un restaurante: WordPress es el camarero y la base de datos es la cocina. Si el camarero no puede entrar en la cocina, no puede servir la comida. El restaurante sigue ahí, la comida sigue ahí, pero no puede llegar a tu mesa.

Este es un problema muy común en servidores Plesk, y la buena noticia es que en el 90% de los casos tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto técnico. A continuación te explico paso a paso cómo diagnosticar y solucionar el error conexión wordpress plesk, desde lo más simple hasta lo más complejo.

Paso 1: Verifica si el servidor de base de datos está activo

El primer paso es comprobar si el servicio de base de datos (MySQL o MariaDB) está funcionando en tu servidor Plesk. A veces el servidor se reinicia o hay una actualización y el servicio queda detenido.

Cómo comprobarlo en Plesk

Inicia sesión en tu panel de Plesk (normalmente en https://tu-dominio.com:8443).
En el menú lateral izquierdo, busca la sección "Herramientas y ajustes".
Dentro de esa sección, busca "Gestor de servicios" o "Servicios del sistema".
Busca en la lista MySQL o MariaDB. Debería aparecer con un estado "Activo" o "En ejecución".

[TIP] Si ves el servicio en rojo o con estado "Detenido", haz clic en el botón de iniciar o reiniciar. Espera unos segundos y vuelve a cargar tu web.

Paso 2: Revisa el archivo wp-config.php

El archivo wp-config.php contiene las credenciales de acceso a tu base de datos. Si estas credenciales son incorrectas, WordPress no podrá conectarse. Este archivo está en la raíz de tu instalación de WordPress.

Cómo acceder al archivo desde Plesk

Entra en Plesk y ve a "Sitios web y dominios".
Haz clic en "Acceso al servidor web" o en el icono de la carpeta de tu dominio.
Navega hasta la carpeta raíz donde está instalado WordPress (normalmente httpdocs o public_html).
Busca el archivo wp-config.php. Haz clic derecho y selecciona "Editar".

Qué debes verificar

Dentro del archivo, 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');

Comprueba que:

El nombre de la base de datos es correcto.
El usuario tiene permisos para acceder a esa base de datos.
La contraseña es exacta, incluyendo mayúsculas, minúsculas y caracteres especiales.
El host es localhost (en la mayoría de casos con Plesk es así).

[WARNING] Ten mucho cuidado al editar este archivo. No borres nada que no sea necesario y guarda una copia de seguridad antes de hacer cambios. Un error de sintaxis puede dejar tu web completamente inaccesible.

Paso 3: Solucionar error base de datos por contraseña incorrecta

El error de conexión más común en WordPress es una contraseña incorrecta. Esto puede pasar si cambiaste la contraseña de la base de datos en Plesk pero no actualizaste el archivo wp-config.php, o viceversa.

Cómo cambiar la contraseña desde Plesk

En Plesk, ve a "Sitios web y dominios" y busca la sección "Bases de datos".
Encuentra tu base de datos de WordPress y haz clic en el icono de usuario (normalmente un engranaje).
Verás una lista de usuarios. Haz clic en el usuario que usa WordPress.
Cambia la contraseña. Plesk te mostrará una contraseña segura o puedes escribir una propia.
Guarda los cambios.

Después de cambiar la contraseña, debes actualizar el archivo wp-config.php con la nueva contraseña. Este es un paso que muchos olvidan, así que presta atención.

[TIP] Una buena práctica es usar la contraseña que Plesk genera automáticamente, ya que es muy segura. Luego solo tienes que copiarla y pegarla en el wp-config.php.

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

A veces la contraseña es correcta, pero el usuario no tiene permisos suficientes para acceder a la base de datos. Esto puede suceder después de migraciones o restauraciones.

Cómo comprobar los permisos

En Plesk, ve a "Bases de datos".
Haz clic en tu base de datos.
Busca la opción de "Usuarios" o "Permisos".
Asegúrate de que el usuario que usa WordPress tenga marcadas las casillas de "TODOS LOS PRIVILEGIOS" o al menos SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, DROP, INDEX.

Si no está marcado, actívalo y guarda los cambios. Luego intenta cargar tu web de nuevo.

Paso 5: Revisa el host de la base de datos

En la mayoría de instalaciones de WordPress en Plesk, el host de la base de datos es localhost. Sin embargo, en algunos servidores configurados de forma especial, puede ser necesario usar una dirección IP o un nombre de host específico.

Cómo saber cuál usar

Si estás en un servidor compartido, localhost suele ser correcto.
Si tienes un VPS o servidor dedicado, revisa la documentación de tu proveedor.
En Plesk, puedes ir a la sección de "Bases de datos" y ver la información de conexión. Suele indicar el host correcto.

[INFO] Si usas un servicio de hosting gestionado, es muy probable que el host sea localhost. No lo cambies a menos que tengas una razón clara.

Paso 6: Comprueba si hay un problema con la versión de PHP

WordPress y sus plugins necesitan una versión de PHP compatible. Si tu sitio usaba una versión antigua y Plesk la actualizó, pueden aparecer errores de conexión.

Cómo cambiar la versión de PHP en Plesk

Ve a "Sitios web y dominios".
Busca la sección de "Configuración de PHP" o "Ajustes de PHP".
Cambia la versión a una más reciente (PHP 7.4, 8.0, 8.1 o 8.2, según lo que soporte tu WordPress).
Guarda los cambios y prueba tu web.

[WARNING] Si tu WordPress es muy antiguo, puede no ser compatible con PHP 8.x. En ese caso, prueba con una versión intermedia como PHP 7.4. Si el problema persiste, consulta con tu proveedor de hosting.

Paso 7: Revisa los logs de error

Plesk guarda registros de errores que pueden darte pistas muy valiosas sobre qué está fallando exactamente.

Dónde encontrar los logs

En Plesk, ve a "Sitios web y dominios".
Busca la sección "Registros" o "Logs".
Abre el registro de errores de tu dominio (suele llamarse error_log).

Busca líneas que contengan palabras como "database", "connection", "mysql" o "PDO". Estas líneas te indicarán el error exacto.

Paso 8: Repara la base de datos

A veces la base de datos está dañada y WordPress no puede conectarse correctamente. Plesk tiene una herramienta para repararla.

Cómo reparar la base de datos

Ve a "Bases de datos" en Plesk.
Selecciona tu base de datos.
Busca la opción "Comprobar" o "Reparar".
Ejecuta la comprobación y, si encuentra errores, ejecuta la reparación.

[TIP] También puedes usar phpMyAdmin, que está integrado en Plesk. Entra en tu base de datos, selecciona todas las tablas y en el menú desplegable elige "Reparar tabla".

Paso 9: Actualiza WordPress y los plugins

Un WordPress desactualizado puede tener problemas de compatibilidad con la base de datos, especialmente después de actualizaciones del servidor. Si puedes acceder al panel de administración (a veces el error solo afecta al front-end), actualiza todo.

Cómo actualizar WordPress

Entra en tu-dominio.com/wp-admin.
Ve a "Escritorio" y busca las actualizaciones disponibles.
Actualiza WordPress, los plugins y los temas.

[INFO] Si no puedes acceder al panel de administración, puedes actualizar WordPress manualmente descargando la última versión desde wordpress.org y subiendo los archivos por FTP, pero esto es más avanzado. Si no te sientes cómodo, contacta con soporte.

Paso 10: Restaura desde una copia de seguridad

Si has probado todo lo anterior y nada funciona, la solución más rápida es restaurar una copia de seguridad anterior. Plesk tiene un sistema de copias de seguridad automático.

Cómo restaurar en Plesk

Ve a "Sitios web y dominios".
Busca la opción "Copias de seguridad" o "Backup".
Selecciona la copia de seguridad más reciente que funcione.
Restaura solo la base de datos o el sitio completo, según prefieras.

[WARNING] La restauración sobrescribirá los datos actuales. Si tienes contenido nuevo que no está en la copia, se perderá. Asegúrate de que esto es lo que quieres antes de continuar.

Preguntas frecuentes sobre el error conexión wordpress plesk

¿Por qué aparece este error después de una actualización de Plesk?

Las actualizaciones de Plesk pueden cambiar la configuración de los servicios, la versión de PHP o los permisos de los archivos. Esto puede romper la conexión a la base de datos. La solución suele ser revisar los pasos 1, 2 y 6 de esta guía.

¿Puedo perder mis datos si cambio la contraseña de la base de datos?

No. Cambiar la contraseña no afecta a los datos. Solo cambia la forma de acceder a ellos. Eso sí, debes actualizar el archivo wp-config.php con la nueva contraseña para que WordPress pueda conectarse.

¿Qué pasa si el error solo aparece en el panel de administración?

Esto suele indicar un problema con un plugin o tema específico. Intenta desactivar todos los plugins renombrando la carpeta wp-content/plugins a wp-content/plugins_old mediante el administrador de archivos de Plesk. Si el error desaparece, reactiva los plugins uno a uno para encontrar el culpable.

¿Es lo mismo este error que el "Error de conexión segura"?

No. El error de conexión a la base de datos es diferente del error SSL o de conexión segura. Este último tiene que ver con los certificados y el protocolo HTTPS. El error de base de datos se refiere exclusivamente a la comunicación entre WordPress y MySQL/MariaDB.

¿Debo contactar con soporte técnico?

Si has seguido todos los pasos de esta guía y el error persiste, es momento de contactar con tu proveedor de hosting. Ellos tienen acceso directo al servidor y pueden diagnosticar problemas más profundos, como corrupción de tablas o problemas de red interna.

Consejos finales para evitar futuros errores de conexión

Para minimizar las posibilidades de que este error vuelva a aparecer, te recomiendo:

Mantén todo actualizado: WordPress, plugins, temas y la versión de PHP.
Haz copias de seguridad periódicas: Plesk puede automatizarlas. Configura copias diarias o semanales.
Anota tus credenciales: Guarda en un lugar seguro el nombre de la base de datos, el usuario y la contraseña.
No cambies cosas sin saber: Si no estás seguro de lo que hace una opción en Plesk, no la toques. Investiga primero o pregunta a soporte.
Usa contraseñas seguras: Para la base de datos y para el acceso a Plesk. Esto evita problemas de seguridad que puedan provocar bloqueos o modificaciones no deseadas.

[INFO] Recuerda que en algunos paneles de control alternativos como Syspanel, el acceso se realiza a través del puerto 2106. Aunque esta guía está enfocada en Plesk, los conceptos son similares en otros paneles.

Resumen rápido de solución

Si no tienes tiempo para leer todo, aquí tienes el resumen de los pasos más efectivos para solucionar error base de datos en WordPress con Plesk:

Reinicia el servicio de MySQL desde el Gestor de servicios.
Verifica las credenciales en wp-config.php.
Cambia la contraseña de la base de datos en Plesk y actualízala en el archivo.
Comprueba los permisos del usuario.
Cambia la versión de PHP.
Repara la base de datos.

En la mayoría de los casos, el problema se resuelve con el paso 2 o el paso 3. No tengas miedo de intentarlo, pues con las copias de seguridad de Plesk siempre puedes volver atrás.

Espero que esta guía te haya sido útil y que hayas podido resolver el plesk wordpress error. Si sigues teniendo problemas, no dudes en dejar un comentario o contactar con tu proveedor de hosting. ¡Buena suerte con tu sitio web!