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

¡Hola! Soy el soporte técnico de hosting. Entiendo que ver un mensaje de error de base de datos en tu WordPress puede ser frustrante, especialmente cuando estás en medio de tu trabajo. No te preocupes, es uno de los problemas más comunes y, por lo general, tiene una solución sencilla.

En este artículo, te guiaré paso a paso para solucionar el temido error de conexión a base de datos en WordPress cuando tu sitio está alojado en un panel Plesk. Veremos desde las causas más básicas (como un cambio de contraseña) hasta soluciones un poco más técnicas (como editar archivos de configuración).

Sigue cada paso con calma. Al final, tu web volverá a funcionar.

¿Qué significa este error? Causas comunes

Cuando WordPress no puede conectar con la base de datos, muestra un mensaje como: "Error al establecer una conexión a la base de datos". Esto sucede porque los datos de conexión (nombre de la base, usuario, contraseña o servidor) son incorrectos o hay un problema en el servidor.

Las causas más frecuentes son:

Cambio de contraseña de la base de datos (la más común).
Corrupción del archivo wp-config.php (por una mala edición o un plugin).
Problemas con el servidor MySQL/MariaDB (caído, sobrecargado o con muchos procesos).
Permisos incorrectos del usuario de la base de datos.
Migración fallida del sitio a otro servidor o dominio.

Paso 1: Lo primero, verifica el estado del servidor

Antes de tocar nada, asegúrate de que el problema no sea general en el servidor.

Intenta acceder a tu panel de Plesk (normalmente https://tudominio.com:8443 o la URL que te hayan dado). Si no cargas, el servidor puede estar caído.
Prueba otro sitio web que tengas en el mismo hosting. Si todos fallan, contacta con tu proveedor de hosting.
Revisa el correo de soporte de tu hosting. A veces envían avisos de mantenimiento o incidencias.

[WARNING] Si el servidor está caído, no sigas con los pasos siguientes. Espera a que el soporte técnico lo reactive.

Paso 2: La solución más común: Restablecer la contraseña de la base de datos en Plesk

El 80% de las veces, este error se soluciona cambiando la contraseña de la base de datos. Es muy fácil:

Accede a Plesk con tus credenciales de administrador.
En el menú de la izquierda, busca y haz clic en Bases de datos (o Databases).
Verás una lista de tus bases de datos. Busca la que usa tu WordPress (suele tener un nombre como tudominio_wp o similar).
Haz clic en el nombre de la base de datos para abrir sus detalles.
Busca la sección Usuario (o Users). Verás un usuario asociado (ej. tudominio_user).
Haz clic en el icono de Cambiar contraseña (normalmente un candado o un lápiz).
Escribe una contraseña nueva y segura. Puedes usar el generador de contraseñas de Plesk (el botón "Generar"). Guárdala en un lugar seguro.
Haz clic en Aceptar o OK.

Ahora, tienes que actualizar el archivo wp-config.php con esta nueva contraseña. Te explico cómo en el siguiente paso.

Paso 3: Editar el archivo `wp-config.php` con los datos correctos

Este archivo es el "corazón" de la conexión. Debes asegurarte de que los datos coincidan con los de Plesk.

Puedes hacerlo de dos formas:

Opción A: Desde el Administrador de Archivos de Plesk (Recomendado)

En Plesk, ve a Archivos (o File Manager).
Navega hasta la carpeta httpdocs (o public_html), que es donde está instalado WordPress.
Busca el archivo wp-config.php. Haz clic derecho sobre él y selecciona Editar (o Edit in Text Editor).

Busca las siguientes líneas (deben estar al principio del archivo):

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'nombre_de_tu_usuario');
define('DB_PASSWORD', 'contraseña_antigua');
define('DB_HOST', 'localhost');

Cámbialas por los datos correctos:
- DB_NAME: El nombre exacto de la base de datos (lo ves en Plesk > Bases de datos).
- DB_USER: El nombre del usuario asociado a esa base.
- DB_PASSWORD: La nueva contraseña que acabas de crear.
- DB_HOST: Normalmente es localhost. Si tu hosting usa un servidor remoto, te lo indicarán (ej. mysql.tudominio.com).
Guarda el archivo (Ctrl+S o Cmd+S).

Opción B: Usando FTP (FileZilla, etc.)

Conéctate a tu servidor vía FTP.
Navega a la carpeta raíz de tu sitio (normalmente public_html).
Descarga el archivo wp-config.php a tu ordenador.
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).
Realiza los mismos cambios que en la Opción A.
Sube el archivo de nuevo, sobrescribiendo el antiguo.

[TIP] Si no encuentras el archivo, puede estar en una subcarpeta. También puedes crearlo de nuevo siguiendo las instrucciones de WordPress.

Paso 4: 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 a la base de datos.

En Plesk, ve a Bases de datos.
Haz clic en el nombre de tu base de datos.
En la sección Usuario, verás una lista de usuarios. Junto a cada uno, suele haber un icono de Permisos (un candado o un engranaje).
Haz clic en ese icono.
Selecciona todos los permisos (o al menos: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP). Para WordPress, lo más seguro es marcar Todos los privilegios.
Haz clic en Aceptar.

Paso 5: Revisar el archivo `wp-config.php` por caracteres extraños

A veces, al copiar y pegar, se cuelan espacios en blanco o caracteres invisibles al principio o final del archivo.

Abre el wp-config.php con un editor de texto limpio (no Word).
Borra cualquier espacio o línea en blanco que haya ANTES de la línea <?php y DESPUÉS de la línea que cierra ?> (si existe). Lo ideal es que no haya nada fuera de las etiquetas PHP.
Guarda y prueba de nuevo.

Paso 6: Solución avanzada: Reparar la base de datos desde Plesk

Si los pasos anteriores no funcionan, podemos intentar reparar la base de datos desde el propio panel.

En Plesk, ve a Bases de datos.
Selecciona tu base de datos.
Busca un botón o enlace que diga Reparar (o Repair Database). A veces está en la sección de herramientas.
Haz clic y espera a que termine. Esto revisa y corrige errores internos de las tablas.

[INFO] Si no ves la opción "Reparar", puedes hacerlo manualmente desde phpMyAdmin (herramienta incluida en Plesk). Accede a phpMyAdmin, selecciona tu base de datos, marca todas las tablas y elige "Reparar tabla" en el menú desplegable.

Paso 7: ¿Sigues con el error? Contacta al soporte técnico

Si después de todo esto el error persiste, el problema puede ser más complejo: el servidor MySQL puede estar caído, hay un error de configuración del servidor, o tu base de datos está corrupta de manera más grave.

En ese caso, contacta con el soporte técnico de tu hosting. Diles que has seguido los pasos de este artículo (cambio de contraseña, revisión de permisos, edición de wp-config.php) y que el error de conexión base de datos WordPress continúa. Ellos podrán revisar los logs del servidor y solucionarlo.

Preguntas Frecuentes (FAQ)

¿Qué hago si no recuerdo la contraseña de la base de datos?

No te preocupes. Puedes cambiarla desde Plesk como explico en el Paso 2. Luego solo tienes que actualizar el archivo wp-config.php con la nueva.

¿Puedo perder datos si cambio la contraseña?

No, cambiar la contraseña solo afecta a la conexión. Tus datos (posts, páginas, usuarios) permanecen intactos en la base de datos.

¿Y si uso otro panel de control como Syspanel (HestiaCP)?

Si usas Syspanel (HestiaCP), el proceso es muy similar. Accede a través del puerto 2106 (ej. https://tudominio.com:2106). Busca la sección de Bases de datos, cambia la contraseña y edita el wp-config.php igual que aquí. Los pasos son casi idénticos.

¿El error puede deberse a un plugin?

Sí, aunque es menos común. Si el error apareció justo después de instalar o actualizar un plugin, intenta desactivarlo. Puedes hacerlo renombrando la carpeta wp-content/plugins desde el Administrador de Archivos (ponle un nombre como plugins_desactivados). Si el error desaparece, el problema está en ese plugin.

¿Qué significa "Error de base de datos" en mi sitio?

Significa que WordPress no puede leer ni escribir en la base de datos. Sin ella, tu web no puede mostrar contenido ni guardar información de usuarios o comentarios.

Resumen rápido

Verifica que el servidor no esté caído.
Cambia la contraseña de la base de datos en Plesk.
Actualiza el archivo wp-config.php con la nueva contraseña.
Revisa los permisos del usuario (todos los privilegios).
Limpia el archivo wp-config.php de espacios extra.
Repara la base de datos desde Plesk o phpMyAdmin.
Contacta al soporte si nada funciona.

¡Mucho ánimo! Este error es molesto, pero casi siempre se soluciona en pocos minutos. Si tienes cualquier duda, déjala en los comentarios y te ayudaré encantado.